Привет!

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



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

В общем, в пятницу, 26 июля, мы в 19.00 собираемся в Deworkacy (Москва, Берсеневская набережная, 6, стр 3) и начинаем документировать говорить про документацию. Список докладов — под катом.

19.00–19.30 Николай Поташников, компания «Курс-ИТ»

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


19.30–20.00 Лана Новикова, компания «Iponweb»

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

20.30–21.00 — перерыв на кофе, нетворкинг.

21.00–21.30 Николай Волынкин, компания «Plesk»

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

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


21.30–22.00 Константин Валеев, компания «Ростелеком Информационные технологии»

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

22.30–23.00 свободное общение

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

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

Комментарии (6)


  1. smarthomeblog
    22.07.2019 14:59

    Планируется ли трансляция?


    1. LeraMityaeva
      22.07.2019 15:13

      Да, трансляция будет в день мероприятия.
      Выложим её в лендинг с регистрацией.


      1. VGusev2007
        23.07.2019 10:04

        Добрый день, подскажите, будет ли доступна запись докладов?

        Спасибо.


        1. LeraMityaeva
          23.07.2019 11:38
          +1

          Да, запись будет!
          Станет доступна здесь в пятницу


  1. worldmind
    22.07.2019 19:25

    Без доклада про DocBook (а может и про DITA, хотя я её не понял) выглядит скучнова-то.


  1. belgak
    23.07.2019 08:34

    Ростелеком на хабре?! Гордо подписываюсь.