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

Питання до читачів: як правильно:

  • 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 описують гайдлайни з проєктування інтерфейсів застосунків для Microsoft Windows, зокрема й гайдлайни з документації для всіх можливих типів елементів керування.

image

Таким чином, серед наведених вище варіантів правильних немає. Правильні варіанти: «Click File», «Click OK».

Якщо хочете бути грамотними, то ця документація — строго до прочитання. Елементів керування багато, рекомендації для всіх різні.

Чи знали ви про ці правила? Чи ви зі школи такі розумні, що пишете англійською без помилок? Чи взагалі вас хвилює, грамотно ви пишете англійською або російською? Усі небайдужі блогери запрошуються в коменти.

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