Клуб технических писателей

Программа пятого Гипербатона

Юрий
16 мая, 12:00

Добрый день,

Опубликована программа пятого Гипербатона, который состоится 3 июня в Москве.

Докладчиками на конференции выступят сотрудники Яндекса, Лаборатории Касперского, Positive Technologies и Сигнатек.

Напоминаем, что участие в конференции бесплатное, но необходимо зарегистрироваться. Регистрация закрывается 29 мая в 16:00 по московскому времени.

Количество мест ограничено. Мы просматриваем все заявки вручную, поэтому могут быть некоторые задержки в получении ответа по статусу участия.

Да пребудет с вами Сила!

8 комментариев
Подписаться на комментарии к посту
Антон Быканов
16 мая, 13:07
Интересно вот что услышать: 
1) Как Вы боритесь с нежеланием или отсутствием времени у программистов, которые должны объяснять суть кода/решения/нового сервиса/продукта?
    1.1) Нормальна ли ситуация, если проще посмотреть в исходном коде чем ждать ответа программиста?
2) Как Вы мотивируете тех. писателей больше практиковаться в программировании?
3) Как оплачивается труд тех. писателя, который занимаются не только документацией, но и созданием демонстрационных примеров, т.е. используются навыки программирования?
4) Как принято поддерживать актуальность документации большого продукта? И в случае когда мало сотрудников в команде?
5) Что является критерием для оценки квалификации тех. писателя? Как вы оцениваете категорию сотрудника?
Обновлено 16 мая, 13:07
Антон Быканов,
1. Про особенности работы с разработчиками мы рассказывали вот в этом докладе: https://events.yandex.ru/lib/talks/1893/
1.1. Смотреть в коде -- хорошая идея, вне зависимости от того, как вас консультируют. Это позволяет не только ускорить процесс документирования, но и (иногда) найти ошибки в коде (у наших писателей есть такой опыт).

2. Обычно те писатели, которым по долгу службу приходится работать с кодом, сами мотивированы практиковаться в программировании. Нам почти не приходится делать ничего дополнительного, чтобы стимулировать людей развиваться.
3. Мы считаем практику самостоятельного написания примеров нормальной. У нас почти все писатели сами создают демонстрационные примеры (по крайней мере уровня "Hello world").  Сложные примеры могут писаться как писателями (если хватает навыков), так и разработчиками.  Весь публикуемый в документации код проверяется разработчиками.

4. Отчасти данный вопрос рассмотрен вот в этом докладе: https://events.yandex.ru/lib/talks/2842/

5. Это очень обширная тема для обсуждения. Если говорить коротко, то у нас есть требования к различным категориям сотрудников, по наличию набора навыков определяется категория сотрудника.


Приходите на конференцию, будем рады рассказать о нашем опыте и послушать о вашем.
Антон Быканов
17 мая, 11:53
Юрий,
Сколько сотрудников в штате тех.писателей в вашей компании? Сколько из них ответственны за документирование конкретных сервисов?
Антон Быканов,
у нас 30 технических писателей. У каждого есть свое направление и / или набор сервисов. И почти у каждого таких сервисов существенно больше одного.
Великолепный Сеня
29 мая, 10:54
В прошлом году прилетал к вам из Владивостока. В этот раз посмотрю трансляцию и обязательно подготовлю вопросы для докладчиков. Да пребудет с вами сила!
Великолепный Сеня,
С интересом ждем вопросов! Подключайтесь к трансляции, будет интересно :)
Великолепный Сеня
3 июня, 08:39
Коллеги, а где можно найти ссылку на прямую трансляцию?
Великолепный Сеня,
Трансляция будет доступна на странице мероприятия в 11 утра