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

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