Всё для технического документирования
+7 (495) 001-00-42
Разработка технической документации
Курсы для технических писателей
Программное обеспечение

Новости о техническом писательстве

Разработка теории пользователя (часть 2)

13.11.2013

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


Распространите свою теорию пользователя

Наверняка в головах различных людей в вашей компании содержится громадное количество отфильтрованных знаний о пользователях. Например, инженеры поддержки тратят целый день на разговоры с пользователями, но их видение может быть пристрастным, так как они говорят только с теми людьми, которые не могут разобраться сами. Продавцы также тратят весь день на разговоры с клиентами. Однако их видение может быть также предвзятым, потому что, разговаривая с людьми, они помогают им принять решение о покупке, а не помогают им использовать продукт. С другой стороны, они часто знают, как никто другой в компании, о том, какие проблемы необходимо решать людям, которые покупают ваш продукт.

Читать дальше…



Разработка теории пользователя (часть 1)

11.11.2013

01Начинаем публикацию статьи Марка Бейкера, специалиста по структурному и основанному на топиках техническому писательству. В данной статье речь идёт о том, что технический писатель должен ясно представлять себе, для кого пишет, а для этого необходимо разработать собственную теорию пользователя.


Каждый документ пишется для читателя, это означает, что у каждого писателя есть теория читателя – идея о том, кто есть читатель. В технических коммуникациях читатель – это пользователь (продукта или сервиса). У каждого технического писателя, таким образом, есть теория пользователя. Эта теория может быть тщательно проработанной или существовать в неявном виде. Она может быть написана или существовать только в голове автора. Она может быть устоявшейся или меняться от начала документа к его концу. Но она всегда существует и имеет значение.

Хотя теория пользователей очевидна, она серьёзно влияет на то, как пишется документ. Она диктует не только выбор лексики и структуры предложения, но также и информации, которая предлагается. Она определяет, будет ли писатель определять понятие детально или просто сошлётся на него, как будто оно уже привычно читателю. Она определяет, будет ли писатель давать читателю рекомендацию провести некоторые задания для себя или попросить сделать их кого-то ещё.

Читать дальше…



Почему писательство – единственная профессия, на которую не влияют её инструменты?

09.08.2013

01В настоящей статье Марк Бейкер говорит о том, что не согласен с мнением Ларри Кунца из предыдущей новости в том, что работа технического писателя не меняется по сути при появлении новых инструментов и приводит достаточно убедительные доводы.


Почему писательство – единственная профессия, на которую не влияют её инструменты? Ларри Кунц недавно опубликовал в своём блоге заметку на похожую тему: Инструменты приходят и уходят. Я по-прежнему писатель

Я писатель. Когда-то я использовал пишущую машинку. Теперь я использую XML-редакторы. Если я останусь в профессии ещё достаточно долго, появятся другие инструменты, и я научусь ими пользоваться.

Моя старая пишущая машинка в прошлом. Но я всё тот же писатель, я есть всегда.

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

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

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

Читать дальше…