Я пишу руководство пользователя, и я пришел к обсуждению с коллегой. Он говорит, что я не могу использовать слово "ты" в любом месте руководства. Теперь я помню кое-что об этом в школе, но это было не для написания процедур. Кроме того, выполняя некоторые поисковые запросы, я заметил, что большинство учебников, где его много используют. Я бы предпочел использовать его, но только если это считается хорошей практикой. как вы думаете?
Некоторые люди считают, что руководства должны быть написаны так, как если бы они были научными работами. Другие считают, что важна техническая точность и читаемость. Я из последнего убеждения - использую "ты", если он соответствует вашему общему стилю, но должен быть последовательным в твоем использовании - я нахожу документы, которые переключаются между "ты" и "мы", раздражающими (и это грех, который я имею был виноват в себе).
Альтернативы, о которых я знаю, следующие:
Мои собственные настройки:
Что легче понять?
Нажмите кнопку. Появится диалоговое окно, в котором вы можете ввести свое имя.
или
Действие нажатия кнопки приведет к появлению диалогового окна, позволяющего пользователю ввести свое имя.
Первое гораздо легче понять. (Использование "вы" иногда может быть неаккуратным, но оно имеет тенденцию быть в тех случаях, когда оно используется в качестве замены "одного" или "некоторых людей" или "людей в целом". Прекрасно использовать его там, где вы на самом деле ссылаясь на человека, читающего текст.)
Вы должны писать объяснения в третьем лице.
Модель потоков Java - это классический пример шаблона Decorator.
Вы должны написать инструкции во втором лице, но даже тогда не все равно, чтобы читать читателя как "вы".
Создайте конструктор, который может инициализировать списки на основе списка списков.
Теперь, как вы себя чувствовали после того, как я выпустил вам 2 команды, мой читатель?
Техническое письмо. Соблюдайте правило использования только пассивного текста. что означает, что вы избегаете "вы", будет хорошей идеей оставаться в безопасности. что на основе того, как я делаю это лично.
Я думаю, что если вы предоставляете императивы, такие как "Открой дверь" или иным образом напрямую обращаетесь к читателю, тогда вы должны использовать "вы" вместо того, чтобы усложнять понимание, говоря о каком-то абстрактном пользователе.
Даже в научных работах, некоторые из наиболее формального письма я могу думать, это спорно я, мы и другие первый язык является ли человек или не допускается. Насколько учителям грамматики средней школы может понравиться, чтобы вы думали иначе, нет универсально подходящей схемы.
Я сам предпочитаю вторую строчку. Последовательность команд легче отслеживать, чем история в вашей форме.
Я бы сделал то, что делают Google, Microsoft, Yahoo и т.д. Вот случайная страница справки из Google:
http://mail.google.com/support/bin/answer.py?hl=en&answer=8494
показывает, что используется "вы". Вы также можете проверить, как Microsoft пишет свое Руководство пользователя.
В качестве побочного примечания я бы не использовал "я" или "мы".
Я бы сказал, просто будьте осторожны. Это может показаться слишком случайным. Если целевая аудитория является бизнес-y, я бы избегал этого. Однако, если это сценарий для домашних пользователей или маркетинг случайный (думаю, Southwest Airlines), я бы сказал, идите с ним.
Просто не злоупотребляйте. Затем он становится налогом на читателя.
Пример того, как он предназначен для использования?
Все зависит от тона и стиля вашего письма. Формальные подходы препятствуют использованию "вас". Лично мне нравится использовать стиль, который является кратким, точным и относительно неформальным. У меня нет проблем с словом "ты" при использовании экономно.
Избегайте использования, как в:
Если вы хотите запустить приложение, вам необходимо ввести свой пароль, а затем вы должны выбрать функцию, которую хотите использовать.
Из справочника технического письма. 8-е издание (стр. 262):
Вы можете сделать предложения короче, оставив некоторые статьи (a, an, the), некоторые местоимения (вы, это, эти) и некоторые глаголы, но такие предложения могут привести к стилю телеграфии и сложнее понять.
Итак, я бы сказал, что все в порядке, чтобы использовать вас, но, как сказал Гилберт Ле Блан в своем комментарии, часто лучше писать "затем нажмите кнопку" вместо "затем нажмите кнопку".
Неперсональная форма должна быть предпочтительной. Использование "вас" было бы слишком ясным, и большинство ваших клиентов будут считать вас не профессионалами. Четкое руководство также уменьшит необходимость поддержки клиентов после продажи и приведет к убыткам для компании.