................ ..................... ..................... ..................... .....

...... ................

.

Профессия «технический писатель»:История и современное состояние

Кирилл Маслинскийведущий разработчик технической документацииГипрбатон, Москва, 24 мая 2014 года

................ ..................... ..................... ..................... .....

...... ................

..........

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

......

.....

.....

.

План

История и контекст

Профессиональная идентичность

Кто все эти люди?

3/26

..........

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

......

.....

.....

.

План

История и контекст

Профессиональная идентичность

Кто все эти люди?

4/26

..........

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

......

.....

.....

.

Технологии и текстыTechnical communication

• «Трактат об астролябии»Чосера (1387?)

• Индустриализация(руководства к швейныммашинам, велосипедами т. п.)

• Первая/Вторая мироваявойна (оформлениеотдельной профессии)

5/26

..........

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

......

.....

.....

.

Технологии и текстыTechnical communication

• «Трактат об астролябии»Чосера (1387?)

• Индустриализация(руководства к швейныммашинам, велосипедами т. п.)

• Первая/Вторая мироваявойна (оформлениеотдельной профессии)

5/26

..........

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

......

.....

.....

.

Технологии и текстыTechnical communication

• «Трактат об астролябии»Чосера (1387?)

• Индустриализация(руководства к швейныммашинам, велосипедами т. п.)

• Первая/Вторая мироваявойна (оформлениеотдельной профессии)

5/26

..........

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

......

.....

.....

.

Разделение труда в IT...и место документации в нем

6/26

..........

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

......

.....

.....

.

Документация в меняющемся мире

• Распределение ценностина разных этапах:

• 1940—1980 hardware• 1980—2000 software• 2000—2014 service (userattention)

• Рост объема написанногокода с годами.

7/26

..........

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

......

.....

.....

.

Документация в меняющемся мире

• Распределение ценностина разных этапах:

• 1940—1980 hardware• 1980—2000 software• 2000—2014 service (userattention)

• Рост объема написанногокода с годами.

7/26

..........

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

......

.....

.....

.

Документация в меняющемся мире

• Распределение ценностина разных этапах:

• 1940—1980 hardware• 1980—2000 software• 2000—2014 service (userattention)

• Рост объема написанногокода с годами.

7/26

..........

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

......

.....

.....

.

Документация в меняющемся мире

• Распределение ценностина разных этапах:

• 1940—1980 hardware• 1980—2000 software• 2000—2014 service (userattention)

• Рост объема написанногокода с годами.

Amit Deshpande, Dirk Riehle The TotalGrowth of Open Source // Proceedingsof the Fourth Conference on OpenSource Systems (OSS 2008). SpringerVerlag, 2008. Page 197-209.

7/26

..........

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

......

.....

.....

.

План

История и контекст

Профессиональная идентичность

Кто все эти люди?

8/26

..........

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

......

.....

.....

.

Сущность профессии по Israel Light

Israel Light

“Technical writing and professionalstatus” (1961)

• технический писатель какпереводчик

риторика умение писать и владениежанрами технических текстов

анализ серьезная научная подготовка

визуализация дизайн документов и техническаяграфика

9/26

..........

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

......

.....

.....

.

Сущность профессии по Israel Light

Israel Light

“Technical writing and professionalstatus” (1961)

• технический писатель какпереводчик

риторика умение писать и владениежанрами технических текстов

анализ серьезная научная подготовка

визуализация дизайн документов и техническаяграфика

9/26

..........

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

......

.....

.....

.

В чем наша задача?

Разобраться −→ Изложить

10/26

..........

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

......

.....

.....

.

В чем наша задача?

Разобраться −→ Изложить

10/26

..........

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

......

.....

.....

.

Кто мы?

• Пишущиеинженеры?

• Техническиподкованныеписатели?

• Аналитики?

«Я могу описать что угодно» — нет.Конечно, нет. Чтобы что-то хорошонаписать, описать, тебе нужнознать ту область, в которой тыработаешь. Быть в нее глубокозабуренным. То есть ты должен бытьинженером.

11/26

..........

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

......

.....

.....

.

Кто мы?

• Пишущиеинженеры?

• Техническиподкованныеписатели?

• Аналитики?

Я даже не знаю, может мне даже не нагуманитарное надо было изначальноидти, а на техническое. Может, уменя склад ума аналитический иличто-то среднее междугуманитарным и аналитическим.

11/26

..........

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

......

.....

.....

.

Кто мы?

• Пишущиеинженеры?

• Техническиподкованныеписатели?

• Аналитики?

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

11/26

..........

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

......

.....

.....

.

Что для нас важно?

• исследование• результат• нас читают

У меня мозг работает реально, а нескучает.

Да в этой работе, по-моему, бонусстандартный: по чему-тоотносительно сложному.. что-тосложное сделать простым.

12/26

..........

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

......

.....

.....

.

Что для нас важно?

• исследование• результат• нас читают

Нравится конец работы.Удовлетворение: вот висяткрасивенькие разделы, подразделы. Апотом приятнее, что ты вот это всесделаешь и станет еще совершеннеекусок работы. Иметь вот эту точкув конце: да, я все сделал, вот оновисит, оно радует людей, помогает.

12/26

..........

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

......

.....

.....

.

Что для нас важно?

• исследование• результат• нас читают

12/26

..........

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

......

.....

.....

.

План

История и контекст

Профессиональная идентичность

Кто все эти люди?

13/26

..........

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

......

.....

.....

.

Откуда берутся техписатели

The trend in the answers is that no one sets out to be a tech writer,you just fall into it. — Tom Johnson

— Случайность :)

— Вообще куча случайностей и всякого непредсказуемого.Никогда не хотела быть техническим писателем ивообще считала, что это работа скучная и сейчаспридерживаюсь такого же мнения. Вот. За исключениемнекоторым.

— Обычно человек в техническое писательство приходитчаще вот как я вижу — случайно. Ему нравится писать. Тоесть он работает в какой-то области, ему нравитсяписать тексты, ему нравится, когда его читают. И ончуть-чуть, просто смещает вектор.

14/26

..........

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

......

.....

.....

.

Образовательные траектории

Israel Light, 1961It is the author’s conviction that those who can write are easilyidentified early in their academic life. In order to be useful, however,they must know something about what to write.

• техническое образование + умение писать• гуманитарное образование + технические знания

15/26

..........

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

......

.....

.....

.

Техписатель в России сегодняНебольшое демографическое исследование

• 128 резюме техническихписателей

• из них 49 — сотрудникиЯндекса

16/26

..........

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

......

.....

.....

.

Возраст

17/26

..........

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

......

.....

.....

.

Пол

18/26

..........

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

......

.....

.....

.

Образование

19/26

..........

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

......

.....

.....

.

Начало карьеры

20/26

..........

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

......

.....

.....

.

Вход в профессию

21/26

..........

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

......

.....

.....

.

Смежные профессии

22/26

..........

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

......

.....

.....

.

Технологии

23/26

..........

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

......

.....

.....

.

Статус профессииТрадиционный подход

• Профессиональное образование• Сертификация специалистов и образовательных программ• Профессиональные общества• Профессиональная этика

24/26

..........

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

......

.....

.....

.

Вместо заключенияIMHO о профессионализме

Объяснять содержание и ценность работы:• привлекать сильных кандидатов интересной работой• привлекать студентов, выбирающих профессию• объяснять заказчикам смысл и место документации• не забывать о читателях, для которых мы работаем

25/26

.

Кирилл Маслинский

ведущий разработчик технической документацииmaslinsky@yandex-team.ru

Клуб техписателей clubs.ya.ru/x-plainyandex-techdoc@yandex-team.ru

................ ..................... ..................... ..................... .....

...... ................