Публикации
Разработка теории пользователя (часть 3)
15.11.2013
В заключительной части статьи Марк Бейкер говорит о необходимости защищать созданную и утверждённую теорию пользователя, о необходимости отсылки к доказательствам положений этой теории и необходимости её постоянного совершенствования.
Защищайте вашу теорию пользователя
Когда документ, в котором закреплена ваша теория пользователя, завершён, и (будем надеяться) подписан широким кругом лиц вашей компании, и включен в официальный план проекта, защищайте его.
Не важно, насколько план может быть основан на фактах или предположениях – когда он завершён, относитесь к нему как к абсолютной истине. Используйте его как пособие по написанию контента, а также по определению образцов вашего контента. Убедитесь, что редакторы и критики критикуют в соответствии с теорией пользователя (и объясните им, что их отзывы имеют небольшую ценность, если они не согласуются с теорией пользователя как контрольной точкой).
Если кто-то просит вас включить контент, который не соответствует теории пользователя, объясните им, что их предложение не соответствует теории пользователя. Если они скажут, что теория неверная, спросите их, как она должна быть изменена и (в идеале) попросите их денег в количестве, достаточном, чтобы удовлетворить их просьбу.
Разработка теории пользователя (часть 2)
13.11.2013
Во второй части статьи Марк Бейкер пишет о необходимости выработки общей теории пользователя для всех сотрудников компании, работа которых зависит от представления о среднестатистическом пользователе разрабатываемого продукта.
Распространите свою теорию пользователя
Наверняка в головах различных людей в вашей компании содержится громадное количество отфильтрованных знаний о пользователях. Например, инженеры поддержки тратят целый день на разговоры с пользователями, но их видение может быть пристрастным, так как они говорят только с теми людьми, которые не могут разобраться сами. Продавцы также тратят весь день на разговоры с клиентами. Однако их видение может быть также предвзятым, потому что, разговаривая с людьми, они помогают им принять решение о покупке, а не помогают им использовать продукт. С другой стороны, они часто знают, как никто другой в компании, о том, какие проблемы необходимо решать людям, которые покупают ваш продукт.
Разработка теории пользователя (часть 1)
11.11.2013
Начинаем публикацию статьи Марка Бейкера, специалиста по структурному и основанному на топиках техническому писательству. В данной статье речь идёт о том, что технический писатель должен ясно представлять себе, для кого пишет, а для этого необходимо разработать собственную теорию пользователя.
Каждый документ пишется для читателя, это означает, что у каждого писателя есть теория читателя – идея о том, кто есть читатель. В технических коммуникациях читатель – это пользователь (продукта или сервиса). У каждого технического писателя, таким образом, есть теория пользователя. Эта теория может быть тщательно проработанной или существовать в неявном виде. Она может быть написана или существовать только в голове автора. Она может быть устоявшейся или меняться от начала документа к его концу. Но она всегда существует и имеет значение.
Хотя теория пользователей очевидна, она серьёзно влияет на то, как пишется документ. Она диктует не только выбор лексики и структуры предложения, но также и информации, которая предлагается. Она определяет, будет ли писатель определять понятие детально или просто сошлётся на него, как будто оно уже привычно читателю. Она определяет, будет ли писатель давать читателю рекомендацию провести некоторые задания для себя или попросить сделать их кого-то ещё.
Техническое писательство в эпоху свободного программного обеспечения (часть 4)
08.11.2013
В заключительной части статьи Марк Райз рассказывает о том, почему грамотность – не самая важная черта хорошего текста, и какой залог – активный или пассивный – правильно использовать в статьях, которые увидят весь мир, и почему. Речь идёт, правда, о статьях на английском языке, но нам, русскоязычной аудитории, также важно знать об этом, потому что тема глобализации актуальна и для российского бизнеса.
4. Новая эпоха технического писательства
В эту новую эпоху, когда написанное автором доступно всегда и везде по всему миру, очень важны глобальный контекст и разные аспекты. Модель открытых источников информации и общество могут дать ещё больше информации, принимая во внимание разнообразие взглядов. Люди в мире с доступными источниками информации эффективно взаимодействуют и находятся во взаимосвязи друг с другом, несмотря на национальные и культурные барьеры на протяжении многих лет.
Из этого опыта мы можем почерпнуть основы успешной работы компании на глобальном рынке. Итак, я предлагаю вашему вниманию несколько важных советов, чтобы вы могли быть уверены в том, что всё, что пишется в вашей компании, остаётся верно функционирующим и эффективным в эту новую эпоху.
Техническое писательство в эпоху свободного программного обеспечения (часть 3)
06.11.2013
В очередной части статьи о преимуществах для технического писательства от свободного программного обеспечения речь идёт о сведениях, которые можно получить из отчётов веб-серверов Apache.
3. Количественный анализ
Даже если редактор достаточно хорош, что может работать над статьёй в одиночку, писателю требуются какие-либо количественные данные, чтобы сделать выводы. Любое дело или организация, у которой нет какого-либо количественного анализа своего контента, теряет большой кусок пирога.
Такой количественный анализ намного легче, чем вы можете подумать – спасибо использованию сегодняшних богатых данными отчётов о доступе к сайтам. Спасибо вам, ребята с проекта Apache!
Онлайн-конференция ТехДок-2013
Дорогие друзья!
27 ноября состоится первая в России конференция, полностью посвящённая вопросам организации процесса документирования программных продуктов и сервисов. Начало в 10:00.
Посещение мероприятия будет интересно:
— руководителям отделов документирования предприятий;
— профессиональным техническим писателям;
— начинающим техническим писателям;
— техническим специалистам, работа которых связана в т.ч. с компетенцией технического писателя;
— студентам вузов.
Полную информацию о конференции и программу мероприятия можно увидеть на сайте: http://protext.su/pro/?page_id=1127. Для посещения обязательна регистрация! Форму регистрации Вы найдёте на той же странице сайта.
Зарегистрировавшимся участникам будет отправлена дополнительная информация.
Ждём всех желающих!
Репост приветствуется 🙂
Техническое писательство в эпоху свободного программного обеспечения (часть 2)
01.11.2013
Вторая часть статьи посвящена тому, что публикуемые сегодня технические статьи должны обновляться, следуя за развитием тех сущностей, которые в них описаны, и полученной обратной связи.
2. Живой документ
Инструменты, инфраструктура и средства коммуникации, доступные в сообществе свободного программного обеспечения, предназначены, чтобы помочь ускорению разработки проектов. В свою очередь, они также создают невероятно эффективные ресурсы для технических писателей.
Как писатель я не только получаю огромное количество от читательских комментариев, циклически проходящих через различные источники обратной связи, но и комментарии напрямую. Мы публикуем статью, она попадает в сеть и распространяется по веб-сайтам, и в течение нескольких часов комментарии появляются по всему миру.
Если автор понимает это и вырабатывает привычку просматривать основные сайты, републикующие новости, то он получает множество преимуществ. Как я уже говорил, автор может сразу же вносить изменения в статью, реагируя на замечания и мысли читателей.
Я усвоил, что кое-что может быть пропущено в детально проработанных справочниках и руководствах пользователя, даже если автор потратил время на повторный просмотр документа, отдал его на проверку редактору и затем ещё раз окончательно прошёлся по нему перед публикацией.
Техническое писательство в эпоху свободного программного обеспечения (часть 1)
30.10.2013
В настоящей статье главный редактор портала ReallyLinux.com размышляет о том, как наличие открытого программного обеспечения влияет на процесс технического писательства
Существует четыре основных способа использовать методы и технологии открытого программного обеспечения, чтобы существенно увеличить эффективность технического писательства любой организации. Эти методы, применяемые в руководствах пользователей, маркетинговых материалах и документации к программному обеспечению, могут значительно усилить возможности технического писательства.
1. Система обратной связи с пользователем
Один из наиболее существенных аспектов совместной работы и коммуникаций – в высшей степени богатая и полезная обратная связь, существующая в сообществе свободного программного обеспечения.
Когда ваша организация публикует статью, маркетинговый документ или руководство пользователя, существует множество способов получить практически незамедлительно обратную связь.
Когда мы публикуем статью на reallylinux, автор может сразу же получить мысли от читателей, не только через прямые комментарии, а также не напрямую, через тысячи комментариев и мыслей на связанных веб-сайтах, повторно публикующих или ссылающихся на статью.
Почему разработчики пишут ужасную документацию
28.10.2013
Сегодняшняя заметка Джеки Сэмюэлс (Jacquie Samuels), консультанта в области технических коммуникаций, DITA, CMS, посвящена причинам, по которым разработчики не должны писать документацию к собственным продуктам.
Мир разработки программного обеспечения может быть стремительно развивающимся и иногда приходится очень сильно напрягаться, чтобы успеть подготовить всё к релизу. Если у компании нет отработанного процесса или отдела технической документации, часто писать документацию на продукт просят разработчиков. Действительно, кто знает продукты так же хорошо, как они?
Даже авторитетная компания может сесть в лужу с документацией, написанной разработчиком. Например, одна компания, разрабатывающая программное обеспечение, обычно пропускающая контент через отдел документирования, напортачила на небольшом, быстром проекте, который был насколько спонтанным, что никто даже и не подумал сказать: «Хорошо бы сказать группе документирования, что ведётся работа над новым продуктом, потому что, знаешь, клиентам как бы нужна документация к продукту». За день до релиза они, наконец, сказали об этом и отправили какой-то разработанный самостоятельно ими контент на быструю вычитку техническим писателем (да, этим писателем была я) в плане правки оформления, орфографии и грамматики – больше времени ни на что не осталось. И в таком виде это отправилось клиенту.
У писателя Джорджа Сондерса выдался замечательный год
25.10.2013
У Джорджа Сондерса (George Saunders) пошла полоса удач.
Писатель и профессор английского языка в Сиракьюсском университете (Syracuse University) на прошлой неделе был признан финалистом Национальной книжной премии за его сборник коротких рассказов «Десятое декабря».
В январе в «Нью-Йорк таймс мэгэзин» (прим. пер.: New York Times Magazine — Воскресное приложение к газете «Нью-Йорк таймс») заголовок гласил: «Джорж Сондерс написал лучшую книгу из тех, что вы прочтёте в этом году».
В апреле он появился в журнале «Тайм» в списке «100 самых влиятельных людей». Автор и коллега по Сиракьюсскому университету Мэри Карр (Mary Karr), пишущая для журнала, назвала Сондерса «лучшим писателем на английском – не «одним из», не «возможно», а Лучшим».
Ранее, в этом месяце, Сондерс получил награду PEN/Malamud 2013 (прим. пер.: PEN – сокращение от International Association of Poets, Playwrights, Editors, Essayists, and Novelists – Международная ассоциация поэтов, драматургов, редакторов, очеркистов и писателей-прозаиков; Malamud Bernard (1914-1986) Маламуд Бернард, Писатель) за «собрание сочинений, которое демонстрирует непревзойдённое мастерство в искусстве написания коротких литературных произведений».