Технический писатель - кто он?
#1
Отправлено 25 февраля 2008 - 18:57
Как правило в проекте существует отдельная роль, в задачи которой входит подготовка технической документации. За эту работу отвечает технический писатель.
Кто в ваших проектах занимается написанием технической документации (проектной, help-ом, набором обучающих документов и т.п.)?
#2
Отправлено 26 февраля 2008 - 08:57
Полтора человека на всю контору.
Хелпы, справки, документация - все к нему. Плюс так же переводы на русский язык.
#3
Отправлено 26 февраля 2008 - 09:19
Технический писатель этим занимается.
Полтора человека на всю контору.
Хелпы, справки, документация - все к нему. Плюс так же переводы на русский язык.
В том то и дело, что далеко не во всех проектах, которые я знаю, привлекался технический писатель для оформления тех документации. И это при том, что в конторе есть техписы.
Видно такая же проблема у других производителей софта. Читая хелпы и доки других контор я зачастую не понимаю что в них написано. И не потому, что я плохо знаю русский. В первую очередь из=за того, что люди сами не знают, что нужно и можно делать с программой.
#4
Отправлено 26 февраля 2008 - 11:52
#5
Отправлено 26 февраля 2008 - 14:41
По-хорошему должен еще кто-то проверить, что все что описано красивым языком в мануале можно применить на практике при работе с программой. Жаль вот только это уже не всегда удается сделать.
Green, а кто же тогда в этих проектах занимался документацией, если писатель есть, но он не привлекается.
#6
Отправлено 26 февраля 2008 - 14:53
Привет!Коллеги!
Как правило в проекте существует отдельная роль, в задачи которой входит подготовка технической документации. За эту работу отвечает технический писатель.
Кто в ваших проектах занимается написанием технической документации (проектной, help-ом, набором обучающих документов и т.п.)?
У нас этим занимаются многие. Т.к. много разной технической документации бывает.
Для понятности, мы работаем над созданием сертификационных продуктов для Java API (в частности, для МЕ, таких как MIDP).
1) JavaDoc спецификации пишут специальные люди (specwriter-ы) - они хорошо понимают разрабатываемую технологию и, собственно, ее придумывают вместе с инженерами, которые имплементируют технологию или проверяют ее.
2) Техническую документацию проекта (внутреннюю) пишут девелоперы, по каким-то шаблонам, скорее всего.
3) Внешнюю документацию (Users Guide, help и тд) - пишут специальный люди (docwriter-ы). В основном, они переводчики с англиского на английский :) Информация к ним поступает от разработчиков и тестеров - они ее пишут правильными английскими словами и предложениями. В продукте зачастую разбираются плохо (в специфике конкретной технологии).
Alexey
#7
Отправлено 04 марта 2008 - 07:22
За оформления внешней документаци (Инструкции по использованию и т.д.), которая ориентирована на конецного пользователя, пишется QA командой . Так как они есть последнии люди кто прикасался к приолжению и знают работающий функционал. После этого дается на прочетения проектноной команде и нескольким постороним и собираются замечания по документации.
В крупных организациях есть выделеный человек для этих целий. Делает тоже самое.
Можно нанять фрилансера но есть риск, что будет некачественая документация (обшики, неполная т.п.), что краней не советую. Практически напише все сами он только деньги возмет. Эфекта ноль
Про внутрению документаци молчу так зависет от процесса разработки ПО
_____________________
За что же, не боясь греха,
Кукушка хвалит Петуха?
За то, что хвалит он Кукушку.
#8
Отправлено 04 марта 2008 - 10:24
Мое мнение, что QA команда ни в коем случае не должна писать никакую документацию для конеЦного пользователя и даже "За оформления". Она, команда, должна проверять, что то, что в этой документации написано, как минимум, написано верно.Доброй время суток!!
За оформления внешней документаци (Инструкции по использованию и т.д.), которая ориентирована на конецного пользователя, пишется QA командой . Так как они есть последнии люди кто прикасался к приолжению и знают работающий функционал. После этого дается на прочетения проектноной команде и нескольким постороним и собираются замечания по документации.
В крупных организациях есть выделеный человек для этих целий. Делает тоже самое.
Можно нанять фрилансера но есть риск, что будет некачественая документация (обшики, неполная т.п.), что краней не советую. Практически напише все сами он только деньги возмет. Эфекта ноль
Про внутрению документаци молчу так зависет от процесса разработки ПО
"Беда, коль пироги начнет печи сапожник, А сапоги тачать пирожник" (с) Крылов И.
Alexey
#9
Отправлено 28 апреля 2009 - 14:35
Внешняя - техпис. QA комментирует и проверяет.
#10
Отправлено 10 июля 2009 - 12:59
#11
Отправлено 15 июля 2009 - 06:45
В этом году была попытка выделить техписа.
В общем - я взялась.
С сентября прошлого года.
Пакет документов для сертификации ПО (начиная от планов , требований к ПО, описания проекта до итогового заключения...). Сделала. Месяца за 4.
Потом - тоже самое для новых релизов.
Параллельно - работа по текущему софту....мм... вплоть до работы в эксплуатации
В общем - проблем с техписом (и технической документацией) не будет, если :
1. В компании достаточно формализованный процесс разработки ПО
2. Роли в проекте распределены.
3. Как минимум - процесс верификации - документируется во время проведения тестирования.....
Т.е. - если есть ОСНОВА, на которой техпис может создавать документы.
Если нет -- то.... в общем.... крайне сложно.
За истекшие месяцы - накопила совершенно специфический опыт.
Количество пользователей, читающих эту тему: 0
0 пользователей, 0 гостей, 0 анонимных