Submit Search
Upload
002 техписатель
•
0 likes
•
1,122 views
Yandex
Follow
18 марта 2014. Я.Студент в ВШЭ Кирилл Маслинский. Я. Технический писатель.
Read less
Read more
Education
Report
Share
Report
Share
1 of 54
Download now
Download to read offline
Recommended
техпис
техпис
Alexandra Kaminskaya
Календар знаменних і пам’ятних дат на 2014/2015 навчальний рік
Календар знаменних і пам’ятних дат на 2014/2015 навчальний рік
Valentina3dan
я у світі 4 кл
я у світі 4 кл
Школа Леди и Кадетство
7
7
7klas
Milena F
Milena F
Nora Gladys Miró
Clase 21 programacion ejb 3.0
Clase 21 programacion ejb 3.0
Pablo Andres Cáceres Ferreira
Wasicunwitkotko
Wasicunwitkotko
ales fiala
Net literacy set up
Net literacy set up
leabonnin
Recommended
техпис
техпис
Alexandra Kaminskaya
Календар знаменних і пам’ятних дат на 2014/2015 навчальний рік
Календар знаменних і пам’ятних дат на 2014/2015 навчальний рік
Valentina3dan
я у світі 4 кл
я у світі 4 кл
Школа Леди и Кадетство
7
7
7klas
Milena F
Milena F
Nora Gladys Miró
Clase 21 programacion ejb 3.0
Clase 21 programacion ejb 3.0
Pablo Andres Cáceres Ferreira
Wasicunwitkotko
Wasicunwitkotko
ales fiala
Net literacy set up
Net literacy set up
leabonnin
N O T O O T H P A S T E D R S H R I N I W A S K A S H A L I K A R
N O T O O T H P A S T E D R S H R I N I W A S K A S H A L I K A R
mgkandalkar
Milena
Milena
carolaiiiii
Status pasien ipd
Status pasien ipd
viadolor
Aborto
Aborto
Vladimir Vilchez Vásquez
June 1 presentation ppt
June 1 presentation ppt
Lauren Proctor
Re diseñar taller de diseño
Re diseñar taller de diseño
carogruffat
Віталій Подоба. “Складний Кейс: Віддалений, Між-Часовий, Part-Time менеджмент”
Віталій Подоба. “Складний Кейс: Віддалений, Між-Часовий, Part-Time менеджмент”
Lviv Startup Club
Predictive Coding Legaltech
Predictive Coding Legaltech
Scott_Wyss
Business Productivity: An Alternative Perspective
Business Productivity: An Alternative Perspective
Garry Gomersall
Tuiter.net - pimpampum.net
Tuiter.net - pimpampum.net
Daniel Julià
Humanidades digitales #datos2013 uba clase 1 gruffat
Humanidades digitales #datos2013 uba clase 1 gruffat
carogruffat
Innovando con TIC en la Educación Superior. La experiencia del Proyecto Facebook
Innovando con TIC en la Educación Superior. La experiencia del Proyecto Facebook
carogruffat
1
1
klas4
Підручник Інформатика 4 клас М. М. Корнієнко, С. М. Крамаровська, І. Т. Зарец...
Підручник Інформатика 4 клас М. М. Корнієнко, С. М. Крамаровська, І. Т. Зарец...
12Балів ГДЗ
Informatyka 4-klas-korniienko-2021
Informatyka 4-klas-korniienko-2021
kreidaros1
3
3
ssuser296d561
10 технол вдовченко_божко_осн_диз_2010_укр
10 технол вдовченко_божко_осн_диз_2010_укр
Aira_Roo
10 информ вдовченко_божко_осн_диз_2010_укр
10 информ вдовченко_божко_осн_диз_2010_укр
Aira_Roo
1
1
klas4
Підручник Інформатика 4 клас Л. З. Козак (2021 рік)
Підручник Інформатика 4 клас Л. З. Козак (2021 рік)
12Балів ГДЗ
Informatyka 4-klas-kozak-2021
Informatyka 4-klas-kozak-2021
kreidaros1
1
1
7klas
More Related Content
Viewers also liked
N O T O O T H P A S T E D R S H R I N I W A S K A S H A L I K A R
N O T O O T H P A S T E D R S H R I N I W A S K A S H A L I K A R
mgkandalkar
Milena
Milena
carolaiiiii
Status pasien ipd
Status pasien ipd
viadolor
Aborto
Aborto
Vladimir Vilchez Vásquez
June 1 presentation ppt
June 1 presentation ppt
Lauren Proctor
Re diseñar taller de diseño
Re diseñar taller de diseño
carogruffat
Віталій Подоба. “Складний Кейс: Віддалений, Між-Часовий, Part-Time менеджмент”
Віталій Подоба. “Складний Кейс: Віддалений, Між-Часовий, Part-Time менеджмент”
Lviv Startup Club
Predictive Coding Legaltech
Predictive Coding Legaltech
Scott_Wyss
Business Productivity: An Alternative Perspective
Business Productivity: An Alternative Perspective
Garry Gomersall
Tuiter.net - pimpampum.net
Tuiter.net - pimpampum.net
Daniel Julià
Humanidades digitales #datos2013 uba clase 1 gruffat
Humanidades digitales #datos2013 uba clase 1 gruffat
carogruffat
Innovando con TIC en la Educación Superior. La experiencia del Proyecto Facebook
Innovando con TIC en la Educación Superior. La experiencia del Proyecto Facebook
carogruffat
Viewers also liked
(12)
N O T O O T H P A S T E D R S H R I N I W A S K A S H A L I K A R
N O T O O T H P A S T E D R S H R I N I W A S K A S H A L I K A R
Milena
Milena
Status pasien ipd
Status pasien ipd
Aborto
Aborto
June 1 presentation ppt
June 1 presentation ppt
Re diseñar taller de diseño
Re diseñar taller de diseño
Віталій Подоба. “Складний Кейс: Віддалений, Між-Часовий, Part-Time менеджмент”
Віталій Подоба. “Складний Кейс: Віддалений, Між-Часовий, Part-Time менеджмент”
Predictive Coding Legaltech
Predictive Coding Legaltech
Business Productivity: An Alternative Perspective
Business Productivity: An Alternative Perspective
Tuiter.net - pimpampum.net
Tuiter.net - pimpampum.net
Humanidades digitales #datos2013 uba clase 1 gruffat
Humanidades digitales #datos2013 uba clase 1 gruffat
Innovando con TIC en la Educación Superior. La experiencia del Proyecto Facebook
Innovando con TIC en la Educación Superior. La experiencia del Proyecto Facebook
Similar to 002 техписатель
1
1
klas4
Підручник Інформатика 4 клас М. М. Корнієнко, С. М. Крамаровська, І. Т. Зарец...
Підручник Інформатика 4 клас М. М. Корнієнко, С. М. Крамаровська, І. Т. Зарец...
12Балів ГДЗ
Informatyka 4-klas-korniienko-2021
Informatyka 4-klas-korniienko-2021
kreidaros1
3
3
ssuser296d561
10 технол вдовченко_божко_осн_диз_2010_укр
10 технол вдовченко_божко_осн_диз_2010_укр
Aira_Roo
10 информ вдовченко_божко_осн_диз_2010_укр
10 информ вдовченко_божко_осн_диз_2010_укр
Aira_Roo
1
1
klas4
Підручник Інформатика 4 клас Л. З. Козак (2021 рік)
Підручник Інформатика 4 клас Л. З. Козак (2021 рік)
12Балів ГДЗ
Informatyka 4-klas-kozak-2021
Informatyka 4-klas-kozak-2021
kreidaros1
1
1
7klas
7 in kor_2020
7 in kor_2020
4book
Informatyka 7-klas-korshunova-2020
Informatyka 7-klas-korshunova-2020
kreidaros1
Спасатель
Спасатель
uxtishka
10 11 информ-малярчук_табл_схем_2007_укр
10 11 информ-малярчук_табл_схем_2007_укр
Aira_Roo
Основи бази даних
Основи бази даних
mgm2019
1
1
booksss100
Зелена книга "Політика відкритих даних"
Зелена книга "Політика відкритих даних"
Better Regulation Delivery Office
Ramk doc chytannya
Ramk doc chytannya
gololobova
Підручник Я досліджую світ 4 клас Н. М. Бібік, Г. П. Бондарчук (2021 рік) Час...
Підручник Я досліджую світ 4 клас Н. М. Бібік, Г. П. Бондарчук (2021 рік) Час...
12Балів ГДЗ
Ya doslidzhuyu-svit-4-klas-bibik-2021-1
Ya doslidzhuyu-svit-4-klas-bibik-2021-1
kreidaros1
Similar to 002 техписатель
(20)
1
1
Підручник Інформатика 4 клас М. М. Корнієнко, С. М. Крамаровська, І. Т. Зарец...
Підручник Інформатика 4 клас М. М. Корнієнко, С. М. Крамаровська, І. Т. Зарец...
Informatyka 4-klas-korniienko-2021
Informatyka 4-klas-korniienko-2021
3
3
10 технол вдовченко_божко_осн_диз_2010_укр
10 технол вдовченко_божко_осн_диз_2010_укр
10 информ вдовченко_божко_осн_диз_2010_укр
10 информ вдовченко_божко_осн_диз_2010_укр
1
1
Підручник Інформатика 4 клас Л. З. Козак (2021 рік)
Підручник Інформатика 4 клас Л. З. Козак (2021 рік)
Informatyka 4-klas-kozak-2021
Informatyka 4-klas-kozak-2021
1
1
7 in kor_2020
7 in kor_2020
Informatyka 7-klas-korshunova-2020
Informatyka 7-klas-korshunova-2020
Спасатель
Спасатель
10 11 информ-малярчук_табл_схем_2007_укр
10 11 информ-малярчук_табл_схем_2007_укр
Основи бази даних
Основи бази даних
1
1
Зелена книга "Політика відкритих даних"
Зелена книга "Політика відкритих даних"
Ramk doc chytannya
Ramk doc chytannya
Підручник Я досліджую світ 4 клас Н. М. Бібік, Г. П. Бондарчук (2021 рік) Час...
Підручник Я досліджую світ 4 клас Н. М. Бібік, Г. П. Бондарчук (2021 рік) Час...
Ya doslidzhuyu-svit-4-klas-bibik-2021-1
Ya doslidzhuyu-svit-4-klas-bibik-2021-1
More from Yandex
Предсказание оттока игроков из World of Tanks
Предсказание оттока игроков из World of Tanks
Yandex
Как принять/организовать работу по поисковой оптимизации сайта, Сергей Царик,...
Как принять/организовать работу по поисковой оптимизации сайта, Сергей Царик,...
Yandex
Структурированные данные, Юлия Тихоход, лекция в Школе вебмастеров Яндекса
Структурированные данные, Юлия Тихоход, лекция в Школе вебмастеров Яндекса
Yandex
Представление сайта в поиске, Сергей Лысенко, лекция в Школе вебмастеров Яндекса
Представление сайта в поиске, Сергей Лысенко, лекция в Школе вебмастеров Яндекса
Yandex
Плохие методы продвижения сайта, Екатерины Гладких, лекция в Школе вебмастеро...
Плохие методы продвижения сайта, Екатерины Гладких, лекция в Школе вебмастеро...
Yandex
Основные принципы ранжирования, Сергей Царик и Антон Роменский, лекция в Школ...
Основные принципы ранжирования, Сергей Царик и Антон Роменский, лекция в Школ...
Yandex
Основные принципы индексирования сайта, Александр Смирнов, лекция в Школе веб...
Основные принципы индексирования сайта, Александр Смирнов, лекция в Школе веб...
Yandex
Мобильное приложение: как и зачем, Александр Лукин, лекция в Школе вебмастеро...
Мобильное приложение: как и зачем, Александр Лукин, лекция в Школе вебмастеро...
Yandex
Сайты на мобильных устройствах, Олег Ножичкин, лекция в Школе вебмастеров Янд...
Сайты на мобильных устройствах, Олег Ножичкин, лекция в Школе вебмастеров Янд...
Yandex
Качественная аналитика сайта, Юрий Батиевский, лекция в Школе вебмастеров Янд...
Качественная аналитика сайта, Юрий Батиевский, лекция в Школе вебмастеров Янд...
Yandex
Что можно и что нужно измерять на сайте, Петр Аброськин, лекция в Школе вебма...
Что можно и что нужно измерять на сайте, Петр Аброськин, лекция в Школе вебма...
Yandex
Как правильно поставить ТЗ на создание сайта, Алексей Бородкин, лекция в Школ...
Как правильно поставить ТЗ на создание сайта, Алексей Бородкин, лекция в Школ...
Yandex
Как защитить свой сайт, Пётр Волков, лекция в Школе вебмастеров
Как защитить свой сайт, Пётр Волков, лекция в Школе вебмастеров
Yandex
Как правильно составить структуру сайта, Дмитрий Сатин, лекция в Школе вебмас...
Как правильно составить структуру сайта, Дмитрий Сатин, лекция в Школе вебмас...
Yandex
Технические особенности создания сайта, Дмитрий Васильева, лекция в Школе веб...
Технические особенности создания сайта, Дмитрий Васильева, лекция в Школе веб...
Yandex
Конструкторы для отдельных элементов сайта, Елена Першина, лекция в Школе веб...
Конструкторы для отдельных элементов сайта, Елена Першина, лекция в Школе веб...
Yandex
Контент для интернет-магазинов, Катерина Ерошина, лекция в Школе вебмастеров ...
Контент для интернет-магазинов, Катерина Ерошина, лекция в Школе вебмастеров ...
Yandex
Как написать хороший текст для сайта, Катерина Ерошина, лекция в Школе вебмас...
Как написать хороший текст для сайта, Катерина Ерошина, лекция в Школе вебмас...
Yandex
Usability и дизайн - как не помешать пользователю, Алексей Иванов, лекция в Ш...
Usability и дизайн - как не помешать пользователю, Алексей Иванов, лекция в Ш...
Yandex
Cайт. Зачем он и каким должен быть, Алексей Иванов, лекция в Школе вебмастеро...
Cайт. Зачем он и каким должен быть, Алексей Иванов, лекция в Школе вебмастеро...
Yandex
More from Yandex
(20)
Предсказание оттока игроков из World of Tanks
Предсказание оттока игроков из World of Tanks
Как принять/организовать работу по поисковой оптимизации сайта, Сергей Царик,...
Как принять/организовать работу по поисковой оптимизации сайта, Сергей Царик,...
Структурированные данные, Юлия Тихоход, лекция в Школе вебмастеров Яндекса
Структурированные данные, Юлия Тихоход, лекция в Школе вебмастеров Яндекса
Представление сайта в поиске, Сергей Лысенко, лекция в Школе вебмастеров Яндекса
Представление сайта в поиске, Сергей Лысенко, лекция в Школе вебмастеров Яндекса
Плохие методы продвижения сайта, Екатерины Гладких, лекция в Школе вебмастеро...
Плохие методы продвижения сайта, Екатерины Гладких, лекция в Школе вебмастеро...
Основные принципы ранжирования, Сергей Царик и Антон Роменский, лекция в Школ...
Основные принципы ранжирования, Сергей Царик и Антон Роменский, лекция в Школ...
Основные принципы индексирования сайта, Александр Смирнов, лекция в Школе веб...
Основные принципы индексирования сайта, Александр Смирнов, лекция в Школе веб...
Мобильное приложение: как и зачем, Александр Лукин, лекция в Школе вебмастеро...
Мобильное приложение: как и зачем, Александр Лукин, лекция в Школе вебмастеро...
Сайты на мобильных устройствах, Олег Ножичкин, лекция в Школе вебмастеров Янд...
Сайты на мобильных устройствах, Олег Ножичкин, лекция в Школе вебмастеров Янд...
Качественная аналитика сайта, Юрий Батиевский, лекция в Школе вебмастеров Янд...
Качественная аналитика сайта, Юрий Батиевский, лекция в Школе вебмастеров Янд...
Что можно и что нужно измерять на сайте, Петр Аброськин, лекция в Школе вебма...
Что можно и что нужно измерять на сайте, Петр Аброськин, лекция в Школе вебма...
Как правильно поставить ТЗ на создание сайта, Алексей Бородкин, лекция в Школ...
Как правильно поставить ТЗ на создание сайта, Алексей Бородкин, лекция в Школ...
Как защитить свой сайт, Пётр Волков, лекция в Школе вебмастеров
Как защитить свой сайт, Пётр Волков, лекция в Школе вебмастеров
Как правильно составить структуру сайта, Дмитрий Сатин, лекция в Школе вебмас...
Как правильно составить структуру сайта, Дмитрий Сатин, лекция в Школе вебмас...
Технические особенности создания сайта, Дмитрий Васильева, лекция в Школе веб...
Технические особенности создания сайта, Дмитрий Васильева, лекция в Школе веб...
Конструкторы для отдельных элементов сайта, Елена Першина, лекция в Школе веб...
Конструкторы для отдельных элементов сайта, Елена Першина, лекция в Школе веб...
Контент для интернет-магазинов, Катерина Ерошина, лекция в Школе вебмастеров ...
Контент для интернет-магазинов, Катерина Ерошина, лекция в Школе вебмастеров ...
Как написать хороший текст для сайта, Катерина Ерошина, лекция в Школе вебмас...
Как написать хороший текст для сайта, Катерина Ерошина, лекция в Школе вебмас...
Usability и дизайн - как не помешать пользователю, Алексей Иванов, лекция в Ш...
Usability и дизайн - как не помешать пользователю, Алексей Иванов, лекция в Ш...
Cайт. Зачем он и каким должен быть, Алексей Иванов, лекция в Школе вебмастеро...
Cайт. Зачем он и каким должен быть, Алексей Иванов, лекция в Школе вебмастеро...
Recently uploaded
exam ЄВІ example of this exam for students for masters degree 2024
exam ЄВІ example of this exam for students for masters degree 2024
OASISENGLISHOFFICIAL
Хвороби картоплі та заходи боротьби з ними
Хвороби картоплі та заходи боротьби з ними
tetiana1958
Роль українців у перемозі в Другій світовій війні
Роль українців у перемозі в Другій світовій війні
estet13
Спектроскоп. Спостереження оптичних явищ
Спектроскоп. Спостереження оптичних явищ
Oleksii Voronkin
Відкрита лекція на тему: "Сидерати - як спосіб виживання"
Відкрита лекція на тему: "Сидерати - як спосіб виживання"
tetiana1958
Балади про Робіна Гуда. Аналіз образу Робіна Гуда
Балади про Робіна Гуда. Аналіз образу Робіна Гуда
Adriana Himinets
Габон
Габон
CupCakeDoo
Україна в умовах десталінізації (1953 – 1964 рр.).pptx
Україна в умовах десталінізації (1953 – 1964 рр.).pptx
gravebabyjohn
Recently uploaded
(8)
exam ЄВІ example of this exam for students for masters degree 2024
exam ЄВІ example of this exam for students for masters degree 2024
Хвороби картоплі та заходи боротьби з ними
Хвороби картоплі та заходи боротьби з ними
Роль українців у перемозі в Другій світовій війні
Роль українців у перемозі в Другій світовій війні
Спектроскоп. Спостереження оптичних явищ
Спектроскоп. Спостереження оптичних явищ
Відкрита лекція на тему: "Сидерати - як спосіб виживання"
Відкрита лекція на тему: "Сидерати - як спосіб виживання"
Балади про Робіна Гуда. Аналіз образу Робіна Гуда
Балади про Робіна Гуда. Аналіз образу Робіна Гуда
Габон
Габон
Україна в умовах десталінізації (1953 – 1964 рр.).pptx
Україна в умовах десталінізації (1953 – 1964 рр.).pptx
002 техписатель
1.
........ ............................................................ ....
..... ........ .
2.
. Я.Технический писатель Кирилл Маслинский maslinsky@yandex-team.ru ведущий
разработчик технической документации Яндекс, Санкт-Петербург 18.03.2014 / Я.Студент Москва ........ ............................................................ .... ..... ........ .
3.
..... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . ..... . .... . .... . Outline Профессия — технический
писатель Немного истории Профессиональная идентичность Документация в IT Писатель и компания Документирование в Яндексе Кто мы О чем мы пишем Как мы работаем Разбираемся Пишем Оцениваем результат 3 / 41
4.
..... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . ..... . .... . .... . План Профессия — технический
писатель Немного истории Профессиональная идентичность Документация в IT Писатель и компания Документирование в Яндексе Кто мы О чем мы пишем Как мы работаем Разбираемся Пишем Оцениваем результат 4 / 41
5.
..... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . ..... . .... . .... . Истоки • «Трактат об
астролябии» Чосера (1387?) • Индустриализация (руководства к швейным машинам, велосипедам и т. п.) • Первая/Вторая мировая война (оформление отдельной профессии) 5 / 41
6.
..... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . ..... . .... . .... . Истоки • «Трактат об
астролябии» Чосера (1387?) • Индустриализация (руководства к швейным машинам, велосипедам и т. п.) • Первая/Вторая мировая война (оформление отдельной профессии) 5 / 41
7.
..... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . ..... . .... . .... . Истоки • «Трактат об
астролябии» Чосера (1387?) • Индустриализация (руководства к швейным машинам, велосипедам и т. п.) • Первая/Вторая мировая война (оформление отдельной профессии) 5 / 41
8.
..... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . ..... . .... . .... . Профессионалы и любители technical
communication Bell, I. T. (1890). Bicycling for women Ward, M. E. (1896). Bicycling for ladies Sarah Hallenbeck (2012) User Agency, Technical Communication, and the 19th-Century Woman Bicyclist, Technical Communication Quarterly, 21:4, 290-306 6 / 41
9.
..... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . ..... . .... . .... . Новые жанры документов 7
/ 41
10.
..... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . ..... . .... . .... . Разделение труда Кто писал
документацию: • специально нанятые журналисты • сами инженеры • профессиональные техписатели 8 / 41
11.
..... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . ..... . .... . .... . План Профессия — технический
писатель Немного истории Профессиональная идентичность Документация в IT Писатель и компания Документирование в Яндексе Кто мы О чем мы пишем Как мы работаем Разбираемся Пишем Оцениваем результат 9 / 41
12.
..... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . ..... . .... . .... . Сущность профессии по
Israel Light Israel Light “Technical writing and professional status” (1961) • технический писатель как переводчик риторика умение писать и владение жанрами технических текстов анализ серьезная научная подготовка визуализация дизайн документов и техническая графика 10 / 41
13.
..... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . ..... . .... . .... . Сущность профессии по
Israel Light Israel Light “Technical writing and professional status” (1961) • технический писатель как переводчик риторика умение писать и владение жанрами технических текстов анализ серьезная научная подготовка визуализация дизайн документов и техническая графика 10 / 41
14.
..... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . ..... . .... . .... . Карьерные траектории Israel Light,
1961 It is the author’s conviction that those who can write are easily identified early in their academic life. In order to be useful, however, they must know something about what to write. • техническое образование + умение писать • гуманитарное образование + технические знания 11 / 41
15.
..... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . ..... . .... . .... . План Профессия — технический
писатель Немного истории Профессиональная идентичность Документация в IT Писатель и компания Документирование в Яндексе Кто мы О чем мы пишем Как мы работаем Разбираемся Пишем Оцениваем результат 12 / 41
16.
..... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . ..... . .... . .... . Процесс разработки... и место
документации в нем 13 / 41
17.
..... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . ..... . .... . .... . Документация в меняющемся
мире • Распределение ценности на разных этапах: • 1940—1980 hardware • 1980—2000 software • 2000—2014 service (user attention) • Рост объема написанного кода с годами. 14 / 41
18.
..... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . ..... . .... . .... . Документация в меняющемся
мире • Распределение ценности на разных этапах: • 1940—1980 hardware • 1980—2000 software • 2000—2014 service (user attention) • Рост объема написанного кода с годами. 14 / 41
19.
..... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . ..... . .... . .... . Документация в меняющемся
мире • Распределение ценности на разных этапах: • 1940—1980 hardware • 1980—2000 software • 2000—2014 service (user attention) • Рост объема написанного кода с годами. 14 / 41
20.
..... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . ..... . .... . .... . Документация в меняющемся
мире • Распределение ценности на разных этапах: • 1940—1980 hardware • 1980—2000 software • 2000—2014 service (user attention) • Рост объема написанного кода с годами. Amit Deshpande, Dirk Riehle The Total Growth of Open Source // Proceedings of the Fourth Conference on Open Source Systems (OSS 2008). Springer Verlag, 2008. Page 197-209. 14 / 41
21.
..... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . ..... . .... . .... . Тем временем в
России... 15 / 41
22.
..... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . ..... . .... . .... . План Профессия — технический
писатель Немного истории Профессиональная идентичность Документация в IT Писатель и компания Документирование в Яндексе Кто мы О чем мы пишем Как мы работаем Разбираемся Пишем Оцениваем результат 16 / 41
23.
..... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . ..... . .... . .... . Внутренняя документация 17 /
41
24.
..... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . ..... . .... . .... . Внутренняя документация 17 /
41
25.
..... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . ..... . .... . .... . Служба извлечения смысла Иероним
Босх, Извлечение камня глупости (1494) • Извлечение тайных знаний • Ответы на незаданные вопросы • Отсеивание ненужного • Исправление нелогичного 18 / 41
26.
..... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . ..... . .... . .... . Задачи техписателя Разобраться −→
Изложить 19 / 41
27.
..... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . ..... . .... . .... . Задачи техписателя Разобраться −→
Изложить 19 / 41
28.
..... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . ..... . .... . .... . План Профессия — технический
писатель Немного истории Профессиональная идентичность Документация в IT Писатель и компания Документирование в Яндексе Кто мы О чем мы пишем Как мы работаем Разбираемся Пишем Оцениваем результат 20 / 41
29.
..... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . ..... . .... . .... . Сколько нас В идеале
В Яндексе 21 / 41
30.
..... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . ..... . .... . .... . Команда 22 / 41
31.
..... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . ..... . .... . .... . Команда (в разрезе) Возраст 23
/ 41
32.
..... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . ..... . .... . .... . Команда (в разрезе) Пол
и образование 24 / 41
33.
..... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . ..... . .... . .... . Команда (в разрезе) Образование 25
/ 41
34.
..... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . ..... . .... . .... . План Профессия — технический
писатель Немного истории Профессиональная идентичность Документация в IT Писатель и компания Документирование в Яндексе Кто мы О чем мы пишем Как мы работаем Разбираемся Пишем Оцениваем результат 26 / 41
35.
..... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . ..... . .... . .... . Что мы документируем •
Внутренние технологии • Внешние API • Open Source технологии Яндекса • Сервисы Яндекса для пользователей Переводы • на английский DOC.yandex-team.ru 27 / 41
36.
..... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . ..... . .... . .... . Что мы документируем •
Внутренние технологии • Внешние API • Open Source технологии Яндекса • Сервисы Яндекса для пользователей Переводы • на английский API.yandex.ru | .com | .com.tr 27 / 41
37.
..... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . ..... . .... . .... . Что мы документируем •
Внутренние технологии • Внешние API • Open Source технологии Яндекса • Сервисы Яндекса для пользователей Переводы • на английский BEM.info | github 27 / 41
38.
..... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . ..... . .... . .... . Что мы документируем •
Внутренние технологии • Внешние API • Open Source технологии Яндекса • Сервисы Яндекса для пользователей Переводы • на английский HELP.yandex.ru | .ua | .com | .com.tr 27 / 41
39.
..... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . ..... . .... . .... . План Профессия — технический
писатель Немного истории Профессиональная идентичность Документация в IT Писатель и компания Документирование в Яндексе Кто мы О чем мы пишем Как мы работаем Разбираемся Пишем Оцениваем результат 28 / 41
40.
..... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . ..... . .... . .... . План Профессия — технический
писатель Немного истории Профессиональная идентичность Документация в IT Писатель и компания Документирование в Яндексе Кто мы О чем мы пишем Как мы работаем Разбираемся Пишем Оцениваем результат 29 / 41
41.
..... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . ..... . .... . .... . Глубокое погружение в
предмет Из всех источников: • работа с продуктом • разговоры разработчиков • вики • багтрекер • рассылки • КОД 30 / 41
42.
..... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . ..... . .... . .... . Глубокое погружение в
предмет Во всех ролях: • менеджер • разработчик • тестировщик • пользователь • поддержка 30 / 41
43.
..... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . ..... . .... . .... . План Профессия — технический
писатель Немного истории Профессиональная идентичность Документация в IT Писатель и компания Документирование в Яндексе Кто мы О чем мы пишем Как мы работаем Разбираемся Пишем Оцениваем результат 31 / 41
44.
..... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . ..... . .... . .... . Используем профессиональные инструменты •
Большие объемы • Требуется постоянное обновление • Много перекрестных ссылок • Много заимствований (цитирования) • Различные выходные форматы: HTML и PDF • DITA XML + SernaFree 32 / 41
45.
..... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . ..... . .... . .... . Используем профессиональные инструменты •
Большие объемы • Требуется постоянное обновление • Много перекрестных ссылок • Много заимствований (цитирования) • Различные выходные форматы: HTML и PDF • DITA XML + SernaFree 32 / 41
46.
..... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . ..... . .... . .... . Эффект «многабукаф» 33 /
41
47.
..... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . ..... . .... . .... . Коротко и ясно Общие
требования к изложению • Предложения должны быть короткими: одно предложение – один факт. Нормальная длина: 7–15 слов. • Абзацы должны быть не длинными: один абзац – одна законченная мысль. Нормальная длина: 3–5 предложений. • Подзаголовки нужны. Выделяйте в тексте логические блоки и озаглавливайте их. Помните, что в сплошном тексте трудно ориентироваться. • Заголовки делайте максимально короткими и однозначными по смыслу (в конце заголовка знаки препинания не ставятся никогда). 34 / 41
48.
..... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . ..... . .... . .... . Перекрестная вычитка 35 /
41
49.
..... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . ..... . .... . .... . План Профессия — технический
писатель Немного истории Профессиональная идентичность Документация в IT Писатель и компания Документирование в Яндексе Кто мы О чем мы пишем Как мы работаем Разбираемся Пишем Оцениваем результат 36 / 41
50.
..... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . ..... . .... . .... . Оценка качества • отзывы •
посещаемость • карты кликов (click maps) http://metrika.yandex.ru 37 / 41
51.
..... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . ..... . .... . .... . Нас читают :) 38
/ 41
52.
..... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . ..... . .... . .... . Следите за вакансиями http://company.yandex.ru/job/vacancies/ 39
/ 41
53.
..... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . .... . .... . ..... . .... . ..... . .... . .... . Спасибо за внимание! Контакты •
Кирилл Маслинский maslinsky@yandex-team.ru • Вакансии разработчиков технической документации на company.yandex.ru 40 / 41
54.
. Я.Технический писатель Кирилл Маслинский maslinsky@yandex-team.ru ведущий
разработчик технической документации Яндекс, Санкт-Петербург 18.03.2014 / Я.Студент Москва ........ ............................................................ .... ..... ........ .
Download now