Отчет о конференции 'Документирование» сегодня', авг. 2008 г.

Событие

28 августа 2008 г. в Москве состоялась конференция «Документирование сегодня», посвященная разработке технической документации в области информационных технологий. Организатор конференции — компания «Философт». Мероприятие с таким названием мы проводим во второй раз и дальше планируем делать это в начале каждые шесть месяцев (в следующий раз в феврале 2009 г.).

Конференция нужна для того, чтобы специалисты по разработке технической документации могли встретиться друг с другом «в реале», расширить свой профессиональный кругозор, обсудить проблемы профессионального сообщества. Вместе с тем, конференция адресована не только техническим писателям, но и другим людям, которым приходится разрабатывать, заказывать, принимать или активно использовать техническую документацию, например, аналитикам и руководителям ИТ-проектов.

• Аудитория
• Тезисы докладов
• Презентация «Метагайда»
• Результаты анонимного опроса участников
• Фотоотчет Марии Селисской

Аудитория

Аудиторию конференции составляли в основном технические писатели и начальники отделов документирования, всего 60 человек из пяти городов (Екатеринбурга, Коломны, Минска, Москвы и Санкт-Перетбурга).

Участники конференции

Тезисы докладов

Регламент конференции позволял включить в программу три доклада. Чтобы определить, какие темы интересуют участников больше всего, мы провели на форуме опрос. В список лидеров попали (темы перечислены по убыванию популярности):

1. практика документирования в различных компаниях;
2. управление документированием;
3. инструментальные средства.

По этим темам были подготовлены доклады, тезисы которых мы здесь приводим.

Михаил Острогорский	Евгения Леденева	Мария Корьевкина
Подход к оценке сроков создания технической документации	Опыт создания отдела документирования: от идеи до полноценной работы	Технология DITA: обзор возможностей и основные преимущества

Презентация «Метагайда»

На конференции было объявлено о выходе книги Юрия Кагарлицкого «Разработка документации пользователя программного продукта. Методика и стиль изложения». Книга представляет собой существенно переработанную версию документа, известного многим под названием «Метагайд». Участники конференции могли приобрести книгу и получить дарственную надпись от ее автора.

Юрий Кагарлицкий рассказывает участникам конференции о своей книге

Результаты анонимного опроса участников

На каждой конференции мы проводим анонимный опрос участников. Цель опроса — помочь техническим писателям и начальникам отделов документирования сориентироваться на рынке труда. Какие задачи надо уметь решать? Каким инструментарием надо владеть? Сколько денег имеет смысл требовать у работодателя или заказчика за свой труд? Вот что мы пытаемся выяснить и рассказать коллегам.

Анонимность опроса связана с тем, что мы задаем участникам неприличный вопрос: «Сколько вы зарабатываете?». Он оказался настолько болезненным, что в прошлый раз большинство респондентов отказалось отвечать на него даже инкогнито. Из-за этого мы не смогли посчитать статистику и в отчете назвали только минимальную и максимальную суммы. Они были таковы, что нас принялись страшно ругать. По мнению критиков, обнародование этих данных должно было привести к падению вакансий в цене.

Между нами, техписами

Тем не менее, мы приняли решение продолжить проведение опросов и публикацию их результатов. Информация о доходах технических писателей нужна, в первую очередь, самому профессиональному сообществу, поскольку работодатели и кадровые агентства наверняка располагают собственными данными на этот счет. Зато специалисты, не зная рынка, рискуют как неоправданно занизить свои требования, так и «остаться с носом», запросив неприемлемые для рынка деньги. Вероятно, нам удалось убедить в этом коллег, поскольку на этот раз к вопросу о доходах они отнеслись гораздо лояльнее. Спасибо!

Итак, по окончании конференции мы получили 51 заполненную анкету. Обработанные данные представлены в табл. 1.

Таблица 1. Результаты опроса участников конференции «Документирование сегодня», авг. 2008 г.

1. В организации (подразделении) какого профиля вы работаете?
в ИТ-компании	75% (38 из 51)
в ИТ-департаменте не ИТ-компании	18% (9 из 51)
я фрилансер	4% (2 из 51)
в организации другого профиля	8% (4 из 51)
2. Какая у вас должность?
технический писатель	82% (42 из 51)
преподаватель	2% (1 из 51)
начальник отдела документации	8% (4 из 51)
другая	10% (5 из 51)
3. На каких языках вы пишете?
на русском	90% (46 из 51)
на английском	20% (10 из 51)
на других	2% (1 из 51)
4. Что вы документируете?
программные продукты	88% (45 из 51)
заказные системы	18% (9 из 51)
бизнес-процессы	29% (15 из 51)
оборудование	10% (5 из 51)
внутренние системы нашей организации	12% (6 из 51)
ИТ-инфраструктуру нашей организации	4% (2 из 51)
другое	10% (5 из 51)
5. Какие аспекты документируемых решений вы описываете?
концепции, "видения"	36% (18 из 50)
требования	34% (17 из 50)
технические решения, алгоритмы	40% (20 из 50)
структуры БД, программный код	30% (15 из 50)
ввод в эксплуатацию (монтаж и т.п.)	30% (15 из 50)
целевое применение	60% (30 из 50)
тех. обслуживание, ремонт	10% (5 из 50)
утилизацию	10% (5 из 50)
другое	6% (3 из 50)
6. Какими стандартами вы пользуетесь?
ГОСТ 34, 19, 2	48% (24 из 50)
ИСО/МЭК	10% (5 из 50)
IEEE	6% (3 из 50)
стандартами нашей организации	58% (29 из 50)
никакими	12% (6 из 50)
другими	2% (1 из 50)
7. Каким инструментарием вы пользуетесь?
FrameMaker	8% (4 из 51)
DITA	8% (4 из 51)
Microsoft Word	82% (42 из 51)
DocBook	18% (9 из 51)
Help&Manual	24% (12 из 51)
OpenOffice	10% (5 из 51)
TeX	12% (6 из 51)
RoboHELP	4% (2 из 51)
MS Help/HTML Help Workshop	22% (11 из 51)
Wiki	12% (6 из 51)
другими	18% (9 из 51)
8. Документы в каких форматах вы выпускаете?
неформатированный текст	2% (1 из 51)
файл HTML одной страницей	10% (5 из 51)
набор HTML-страниц с навигацией	25% (13 из 51)
копии, распечатанные на принтере	29% (15 из 51)
MS Word	75% (38 из 51)
Unix man	0% (0 из 51)
Eclipse	0% (0 из 51)
книги	8% (4 из 51)
WinHelp	12% (6 из 51)
JavaHelp	2% (1 из 51)
FlashHelp	0% (0 из 51)
Wiki	10% (5 из 51)
RTF	10% (5 из 51)
PDF	69% (35 из 51)
CHM	37% (19 из 51)
XML	16% (8 из 51)
в других	6% (3 из 51)
9. В каком коллективе вы обычно решаете поставленные перед вами задачи?
самостоятельно	27% (14 из 51)
в группе технических писателей	37% (19 из 51)
в проектной команде, состоящей из специалистов разных профилей	37% (19 из 51)
10. Сколько приблизительно технических писателей в вашей компании?
0	4% (2 из 50)
1	22% (11 из 50)
2-5	40% (20 из 50)
5-10	16% (8 из 50)
10-20	18% (9 из 510)
много	6% (3 из 50)
11. Где находится ваше основное рабочее место?
в офисе у работодателя	96% (48 из 50)
в офисе у заказчика	2% (1 из 50)
дома	8% (4 из 50)
в другом месте	2% (1 из 50)
12. Каков характер вашей занятости?
одна постоянная работа	80% (41 из 51)
постоянная работа + фриланс	10% (5 из 51)
несколько постоянных работ	4% (2 из 51)
стопроцентный фриланс	0% (0 из 51)
13. Каков ваш график работы?
надо ходить в офис каждый день, время прихода и ухода строго определено	63% (32 из 51)
свободный график или два-три присутственных дня в неделю	10% (5 из 51)
надо ходить в офис каждый день, но по времени свободно	25% (13 из 51)
полностью удаленная работа	2% (1 из 51)
14. По вашим оценкам, в среднем, сколько часов в день вы работаете?
6 часов или меньше	22% (11 из 51)
7-9 часов	73% (37 из 51)
10-12 часов	4% (2 из 51)
13 часов или больше	2% (1 из 51)
15. Каков ваш средний месячный доход от профессиональной деятельности?
30 тыс. руб. или меньше	32% (16 из 50)
31-45 тыс. руб.	32% (16 из 50)
46-60 тыс. руб.	18% (9 из 50)
61-75 тыс. руб.	10% (5 из 50)
76-90 тыс. руб.	6% (3 из 50)
91 тыс. руб. или больше	4% (2 из 50)
16. Вырос ли ваш средний месячный доход за последний год?
нет	14% (7 из 50)
формально да, но инфляция все съела	31% (16 из 50)
определенно да	59% (30 из 50)