ТехДок 2013. С.Милачёва. Усы, лапы и хвост – вот мои...

www.intervale.ru

2013 Светлана Милачева, Intervale

Опыт организации ОТД в IT-компании

Усы, лапы и хвост – вот мои документы.

Эволюция «хомяков»

13.04.23 2www.intervale.ru

Обо мне

9 лет в IT•дизайн, •разработка, •администрирование, •сопровождение и поддержка ПО, •техписательство, •внедрение ПО, •начальник ОЭД.

Образование•ГГУ им. Ф.Скорины•МИЭМ.

Дополнительно•Курсы, он-лайн курсы•Профильные конференции.


Определение понятий

*Хомяк Кто: исчезающий в 21 веке вид homepage (англ. домашняя страничка). Когда: был популярен в 20 веке, в эпоху зарождения IT-индустрии, до появления соцсетей.Среда обитания: водится в маленьких компаниях, где пока еще нет острой необходимости в грамотно построенном процессе документирования выпускаемых продуктов.

Кустарно сделанный продукт (в нашем случае – документ(ы)), например, написанный «на коленке», созданный непрофессионалом, не отвечающий высоким требованиям потребителя и не являющийся конкурентно- и жизнеспособным в современных рыночных условиях.



*ОТДЧто: отдел технической документации (более узко - ОЭД).Среда обитания: водится в заботливых IT-компаниях.



*Усы, лапы и хвост – это неофициальный докУмент (Усы, лапы и хвост – вот мои документы (с))Посылку вам по нему не выдадут!


Главная тема

Роскошь или

Необходимость

ОТД в IT-компании


Когда и зачем

Итак, если у вас наблюдается подобная картина



Очень много документов. А-А-А!



Что где лежит? А-А-А!



Никто уже и не помнит, как это работает.А-А-А!



Новые сотрудники, а объяснять некогда. И некому. Или и то и другое одновременно. А-А-А!


Зачем

Документацию пишут разработчики«На этом имплементация завершена! Happy coding».А-А-А!



Кажется, бардак начинается… А-А-А!



Если у вас•накопилось много документов•непонятно, что где лежит•и кто за что отвечает•и как это работает•новые сотрудники, а объяснять некогда•наблюдается «happy coding».



Если ваш Продукт на рынке должен выглядеть также презентабельно, как Вы на деловой встрече…



То это знак. Пора!


Пора

Пора прокачать вашего «хомяка»!


Эволюция

Step by Step


Перед стартом

С чего начинать?


Обязательные вопросы

Прежде чем инициировать создание отдела, ответьте на вопросы:•Когда•Зачем•Зоны ответственности •Где искать людей•Как обучать•В чем писать•Где хранить•Перспективы

Бизнес-план.

Команда

Ищите фанатов с горящими глазами.


Команда

Из разных сфер (лингвисты, маркетологи, математики, IT-шники, медики, музыканты, специалисты банковской сферы…).


Команда

С разными взглядами.


Команда

С разным менталитетом и темпераментом.


Среда обитания

• jobs.ru, hh.ru и др.• ВУЗы• Соцсети• Хантинг (вне

компании)• Среди знакомых

своих коллег• Хантить среди

коллег в своей компании

нельзя. Вернется бумерангом.


Где брать самые лучшие кадры

Как обучать

• Мастер-классы.• Конференции, смежные по тематике. • Тренинги.• Перекрестное обучение.• Подружите коллег внутри и вне отдела и они сами друг друга

научат.• В IT-сфере очень важную роль играет самообучение.


Распределение работ

Как делить работу и распределять нагрузку•По интересам.•По темпераменту.•По опыту и способностям.•По направлениям.•По продуктам.•По командам.


Точки над “I”

Эта информация должна быть прозрачна для вас и ваших коллег•FAQ.•Каталог услуг.•Зоны ответственности.•Цели.•Задачи.•Стандарты.•Регламент.•Шаблоны.•Процедуры.


Стандарты

ГОСТ, ISO?А может бытьсобственный

корпоративный стандарт?


Каталог услуг

Каталог услуг отдела


Инструменты

Инструменты по извлечению информации из разработчиков


Инструменты

Создание и верстка документов•MS Word и пр. текстовые процессоры•MikTeX и пр. TeX-и•DocBook, DITA•Syntext Serna •Help&Manual.


Где хранить


Единое хранилище документации

Можно, конечно, и так.Но лучше использовать единое хранилище.

Где хранить


Confluence


SVN


MS SharePoint


Актуализация

Как и когда обновлять документацию•Точечно (мелкие баги, небольшие доработки не в рамках релиза); глобально (морально устарела, неактуальна).•В соответствии с релизной политикой.

Если релизная политика на проекте отсутствует, то ее нужно придумать и внедрить самостоятельно применимо к вашей части на проекте. Например, раз в месяц вы будете проверять статус предмета документирования (ПО, среда, система и т.д.) и обновлять документ\пакет документов.


Контроль качества

Узнайте мнение о своей работе у пользователей документа (коллег и заказчиков) одним из способов, перечисленных ниже.Способы оценки (не человека, а работы ОТД)•Запросите фидбеки.•Передайте на ревью. •Проведите кросс-ревью.•Проинтервьюируйте заказчика.


Карьера


Планы и перспективы

Должны быть!Слушайте своих сотрудников. Они – главные источники идей!



Легенда

Все персонажи вымышленные, все совпадения случайны.


Вопросы

?


Спасибо за внимание

Как со мной связаться•E-mail: [email protected]•Skype: smilacheva•Соцсети.

Спасибо за внимание и до новых встреч!

Источники иллюстраций

• poprage.deviantart.com• Рекламный ролик Kia Soul 2014 Hamster.


ТехДок 2013. С.Милачёва. Усы, лапы и хвост – вот мои...

Technology