Если его Майкрософт включил в свой стайл гайд, оно уже не считается редкоупотребимым. Майкрософт как раз очень много внимания уделяет тому, чтобы язык был понятным не-носителю.

Справедливо.
Посмотрела картинку с вашей кнопкой. Я бы, наверное, написала "click %button% to activate %function%, click the button again to deactivate it"

это да, но все же важнее для кого пишешь и насколько примитивен их уровень языка

при этом понимаю как больно переписывать свои шедевры под симпл инглиш

Да, мне нравится, вот только поймет ли читатель, какое из двух положений активирует... У кнопки тултип не меняется при нажатии.

Для этого можно опять приложить картинки с состояниями

мб тогда поменяете кнопку на переключатель? А то рил неочевидно  что меняется при нажатии, а тем более что при повторном

Да, спасибо!

А вдруг читатель не поймет, что то, что я называю переключатель (toggle) - это кнопка? Будет искать похожий на нее переключатель...

конечно не поймет. Одно дело кнопка, другое - переключатель

опять же эти все обсуждения с минимальным контекстом

Наверное, у нас не самый интуитивный интерфейс. И поэтому нет готовых примеров, потому что обычно это не такой кнопкой делают. Тогда правда можно написать как кажется правильным, без оглядки на популярные стайл гайды...

лукс лайк зэ солюшн!

🤝

вообще как для себя выяснил (опять же поправьте, если неправ!) - стайлгайды больших ребят - большой ориентир, а не ортодоксальная библия, отходить от которой нельзя во избежание текстовой инквизиции

Ну... я люблю, когда все правила описаны в стайл гайде. И удобно, когда за основу гайд больших ребят, а дополнения или противоречащие ему вещи, принятые в компании, описаны в собственном.

или переделать ту кнопку на переключатель. И спать спокойным окр-ным сном потом

😃😃😃

Если по умолчанию документ не кэшируется, то логично написать как включить кэширование. Примерно как у вас и сделано. А дальше упомянуть, что его можно выключить повторным нажатием.

Если изначальное состояние заранее неизвестно, то можно пойти по пути “от общего к частному” и сделать что-то вроде такого:

Use the toggle button (in the toolbar / in the top right corner / etc.) to select whether you want the document to be available offline:

- <icon_enabled>: available offline
- <icon_disabled>: not available offline

Но вообще делать непонятным образом меняющиеся кнопки - такое себе UX решение. Для этого 100500 лет назад придумали чекбоксы (сейчас ещё переключатели модно). Обзываешь его “Available offline” и готово.

etc без точек пишется

все остальное соглы

Спасибо за такой развернутый ответ!

Почему это у нас кнопка - ну, это тулбар, на нем еще другие кнопки, которые не имеют нажатого-отжатого положения. Если менять на чекбокс, это весь дизайн переделывать и придумывать, куда впихнуть чекбокс. Вряд ли это сделают :)

я мб не догоняю. Но в чем проблема физически вместо кнопки переключатель/чекбокс запилить? Верстка капец поедет?