Документация как код в промышленных масштабах | Николай Волынкин | DocFactor'17

 



DocFactor'17, конференция о технической документации. 26 ноября 2017, Новосибирск, НГУ. Документация как код в промышленных масштабах. Николай Волынкин, Plesk, технический писатель Слайды:
История о том, как мы в Plesk внедряем лучшие практики разработки ПО в разработку документации. Какие проблемы были в разработке документации и как мы их решаем. Что такое разработка документации как кода ("docs like code"): легковесные языки разметки, контроль версий, непрерывная интеграция и поставка (CI/CD), контролируемая публикация, связь с разработкой и выпуском продукта. В чём польза для технических писателей и для бизнеса. Как перейти на docs like code, не ломая процессы и не выкидывая легаси. Доклад адресован всем, кто заинтересован в управлении знаниями в компании: техписателям и их руководителям, менеджерам продуктов и проектов, тимлидам и архитекторам, CTO, энтузиастам свободного программного обеспечения. Технологии и ключевые слова: reStructuredText, Sphinx, Markdown, Jekyll, Git, CI/CD, GitLab CI, Docker, pandoc.