Хабрахабр

26 июля, Deworkacy — DocOps от Ростелекома

Привет!

Таких мероприятий обычно не так много, оно и понятно — документация не такая хайповая штука, как React, к примеру. Мы тут решили провести митап по DocOps — это почти как DevOps, только про документацию и всё, что с ней связано. Злые языки вообще утверждают, что от документации зрение портится. Да и не только React, прямо скажем.

Даже тем коллегам, работа которых (на первый взгляд) в документацией не связана. Но она реально важна, с ней работают люди, и чем правильнее и логичнее у вас в компании выстроены процессы работы с документацией, тем всем будет проще.

00 собираемся в Deworkacy (Москва, Берсеневская набережная, 6, стр 3) и начинаем документировать говорить про документацию. В общем, в пятницу, 26 июля, мы в 19. 00–19. Список докладов — под катом.
19. 30 Николай Поташников, компания «Курс-ИТ»

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

30–20. 19. 00 Лана Новикова, компания «Iponweb»

Я расскажу, как мы пытались их примирить в рамках единого подхода, расскажу об опыте настройки публикации артефактов базы знаний команды UI разработки через CI в Confluence как отдельный таргет, что учли заранее, что не учли, что планируем еще сделать и какие «грабли» встретили на пути. Как мы пытались скрестить Sphinx и Confluence
Нередко организацию корпоративной wiki противопоставляют подходу Docs as code.

30–21. 20. 00 — перерыв на кофе, нетворкинг.

00–21. 21. 30 Николай Волынкин, компания «Plesk»

При этом: Замена рельсов под едущим поездом
Меняем инструмент разработки документации на docs-as-code.

  • не останавливаем разработку и публикацию,
  • делаем и сравниваем прототипы на нескольких инструментах,
  • переносим переводы документации,
  • исправляем ошибки и выравниваем стиль в исходном контенте,
  • обходимся без ручной работы.

30–22. 21. 00 Константин Валеев, компания «Ростелеком Информационные технологии»

Ведение репозиториев с документацией
Расскажу, как вести репозиторий с документацией, рассмотрим несколько стандартных подходов, которые можно заимствовать у разработки, и парочку специфичных именно для документирования.

30–23. 22. 00 свободное общение

И еще разок для тех, кто одновременно читал анонс и продолжал документировать.

  • 26 июля, пятница
  • Москва, Берсеневская набережная, 6, стр 3 (Deworkacy, малый лекторий)
  • 19.00–23.00
  • Вход бесплатный.
  • Ссылка на регистрацию.
Теги
Показать больше

Похожие статьи

Добавить комментарий

Ваш e-mail не будет опубликован. Обязательные поля помечены *

Кнопка «Наверх»
Закрыть