Рекомендации для технический писателей

Многие из нас пишут различную документацию на английском языке. Это и презентации, руководства пользователя, хелп-файлы, да и просто постинги в блоги. Вот и я такой же. Мы учим людей с помощью скринкастов, в которых нужно пояснять, что происходит на экране. В сценариях очень много описаний различных элементов управления, вроде «откройте меню Файл», «нажмите кнопку ОК», «выберете вкладку Опции». Я не мог понять, как правильно это писать на английском. Указывать ли артикли? В какой последовательности писать элемент управления и его название?

Вопрос к читателям, как правильно:

• Select menu Open
• Select Open menu
• Select the Open menu

Или в этом случае:

• Press button OK
• Press OK button
• Press the OK button

Я полгода ломал голову, я не мог спать, я забыл про другие развлечения, кроме чтения словаря и грамматических справочников. Когда я ехал в поезде в командировку, я смотрел в окно и перед моими глазами вместо деревьев пробегали кнопки, менюшки, радиобаттоны. Размышляя над этим вопросом я несколько раз на конечной станции в метро забывал выходить из вагона и уезжал в депо. Получая деньги в банке кассир меня спросила: «Ваше ФИО?», я ответил: «дропдаун лист». В ЗАГСе на вопрос: «Согласны ли вы?», я ответил «No to all». Я подходил к случайным прохожим на улице с этими вопросами, но они лишь крутили пальцем у виска и уходили прочь...

Конец затмению. Мой разум так чист, и я вижу теперь что нас ждёт.

По этой ссылке http://msdn.microsoft.com/en-us/library/aa511258.aspx сотрудники Микрософта описывают гайдлайны по проектированию интерфейсов приложений для Microsoft Windows, в том числе и гайдлайны по документации для всех возможных типов элементов управления.

Таким образом среди приведенных выше вариантов правильных нет. Правильные варианты: «Click File», «Click OK».

Если хотите быть грамотными, то эта документация — строго к прочтению. Элементов управления много, рекомендации для всех разные.

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

P. S. А после нашей прошлой беседы про дизайн в документации, кто-нибудь нашел вменяемые шаблоны для Доксигена?