Документация как код в промышленных масштабах (Николай Волынкин, SECR-2017) — различия между версиями

Материал из 0x1.tv

(Batch edit: replace PCRE (\n\n)+(\n) with \2)
 
(не показано 28 промежуточных версий этого же участника)
* Какие проблемы были в разработке документации и как мы их решаем.
* Что такое разработка документации как кода (“docs like code”): легковесные языки разметки, контроль версий, непрерывная интеграция и поставка (CI/CD), контролируемая публикация, связь с разработкой и выпуском продукта.
* В чём польза для технических писателей и для бизнеса.
* Как перейти на docs like code, не ломая процессы и не выкидывая легаси.

Доклад адресован всем, кто заинтересован в управлении знаниями в компании: техписателям и их руководителям, менеджерам продуктов и проектов, тимлидам и архитекторам, CTO, энтузиастам свободного программного обеспечения.

Технологии: reStructuredText, Sphinx, Markdown, Jekyll, Git, CI/CD, GitLab CI, Docker, pandoc.
</blockquote>

{{VideoSection}}
{{vimeoembed|240324927|800|450}}
<!-- {{youtubelink|}} -->
|sVStWzgDnNA}}{{letscomment}}
{{SlidesSection}}
* http://nick.volynkin.gitlab.io/docs-like-code

<!-- [[File:Документация как код в промышленных масштабах (Николай Волынкин, SECR-2017).pdf|left|page=-|300px]] -->

{{----}}
[[File:{{#setmainimage:Документация как код в промышленных масштабах (Николай Волынкин, SECR-2017)!.jpg}}|center|640px]]
{{LinksSection}}
* [http://2017.secrus.ruorg/program/submitted-presentations/docs-like-code-in-enterprise Страничка доклада на сайте конференции]
<!-- <blockquote>[©]</blockquote> -->

{{fblink|1965725253680486}}                                          
{{vklink|967}}                                          
<references/>





<!-- topub -->


{{stats|disqus_comments=0|refresh_time=2018-02-14T16:51:302021-08-31T17:00:21.876220461113|vimeo_comments=0|vimeo_plays=81293|youtube_comments=1|youtube_plays=0179}}

[[Категория:SECR-2017]]
[[Категория:Документирование]]

Текущая версия на 12:20, 4 сентября 2021

Докладчик
Николай Волынкин.jpg
Николай Волынкин

История о том, как мы в Plesk внедряем лучшие практики разработки ПО в разработку документации.

  • Какие проблемы были в разработке документации и как мы их решаем.
  • Что такое разработка документации как кода (“docs like code”): легковесные языки разметки, контроль версий, непрерывная интеграция и поставка (CI/CD), контролируемая публикация, связь с разработкой и выпуском продукта.
  • В чём польза для технических писателей и для бизнеса.
  • Как перейти на docs like code, не ломая процессы и не выкидывая легаси.

Доклад адресован всем, кто заинтересован в управлении знаниями в компании: техписателям и их руководителям, менеджерам продуктов и проектов, тимлидам и архитекторам, CTO, энтузиастам свободного программного обеспечения.

Технологии: reStructuredText, Sphinx, Markdown, Jekyll, Git, CI/CD, GitLab CI, Docker, pandoc.

Видео

on youtube

Посмотрели доклад? Понравился? Напишите комментарий! Не согласны? Тем более напишите.

Презентация

Документация как код в промышленных масштабах (Николай Волынкин, SECR-2017).pdf Документация как код в промышленных масштабах (Николай Волынкин, SECR-2017).pdf Документация как код в промышленных масштабах (Николай Волынкин, SECR-2017).pdf Документация как код в промышленных масштабах (Николай Волынкин, SECR-2017).pdf Документация как код в промышленных масштабах (Николай Волынкин, SECR-2017).pdf Документация как код в промышленных масштабах (Николай Волынкин, SECR-2017).pdf Документация как код в промышленных масштабах (Николай Волынкин, SECR-2017).pdf Документация как код в промышленных масштабах (Николай Волынкин, SECR-2017).pdf Документация как код в промышленных масштабах (Николай Волынкин, SECR-2017).pdf Документация как код в промышленных масштабах (Николай Волынкин, SECR-2017).pdf Документация как код в промышленных масштабах (Николай Волынкин, SECR-2017).pdf Документация как код в промышленных масштабах (Николай Волынкин, SECR-2017).pdf Документация как код в промышленных масштабах (Николай Волынкин, SECR-2017).pdf Документация как код в промышленных масштабах (Николай Волынкин, SECR-2017).pdf Документация как код в промышленных масштабах (Николай Волынкин, SECR-2017).pdf Документация как код в промышленных масштабах (Николай Волынкин, SECR-2017).pdf Документация как код в промышленных масштабах (Николай Волынкин, SECR-2017).pdf Документация как код в промышленных масштабах (Николай Волынкин, SECR-2017).pdf Документация как код в промышленных масштабах (Николай Волынкин, SECR-2017).pdf Документация как код в промышленных масштабах (Николай Волынкин, SECR-2017).pdf Документация как код в промышленных масштабах (Николай Волынкин, SECR-2017).pdf Документация как код в промышленных масштабах (Николай Волынкин, SECR-2017).pdf Документация как код в промышленных масштабах (Николай Волынкин, SECR-2017).pdf Документация как код в промышленных масштабах (Николай Волынкин, SECR-2017).pdf Документация как код в промышленных масштабах (Николай Волынкин, SECR-2017).pdf Документация как код в промышленных масштабах (Николай Волынкин, SECR-2017).pdf Документация как код в промышленных масштабах (Николай Волынкин, SECR-2017).pdf Документация как код в промышленных масштабах (Николай Волынкин, SECR-2017).pdf Документация как код в промышленных масштабах (Николай Волынкин, SECR-2017).pdf Документация как код в промышленных масштабах (Николай Волынкин, SECR-2017).pdf Документация как код в промышленных масштабах (Николай Волынкин, SECR-2017).pdf Документация как код в промышленных масштабах (Николай Волынкин, SECR-2017).pdf Документация как код в промышленных масштабах (Николай Волынкин, SECR-2017).pdf Документация как код в промышленных масштабах (Николай Волынкин, SECR-2017).pdf Документация как код в промышленных масштабах (Николай Волынкин, SECR-2017).pdf Документация как код в промышленных масштабах (Николай Волынкин, SECR-2017).pdf Документация как код в промышленных масштабах (Николай Волынкин, SECR-2017).pdf Документация как код в промышленных масштабах (Николай Волынкин, SECR-2017).pdf Документация как код в промышленных масштабах (Николай Волынкин, SECR-2017).pdf Документация как код в промышленных масштабах (Николай Волынкин, SECR-2017).pdf Документация как код в промышленных масштабах (Николай Волынкин, SECR-2017).pdf Документация как код в промышленных масштабах (Николай Волынкин, SECR-2017).pdf Документация как код в промышленных масштабах (Николай Волынкин, SECR-2017).pdf Документация как код в промышленных масштабах (Николай Волынкин, SECR-2017).pdf Документация как код в промышленных масштабах (Николай Волынкин, SECR-2017).pdf Документация как код в промышленных масштабах (Николай Волынкин, SECR-2017).pdf Документация как код в промышленных масштабах (Николай Волынкин, SECR-2017).pdf Документация как код в промышленных масштабах (Николай Волынкин, SECR-2017).pdf Документация как код в промышленных масштабах (Николай Волынкин, SECR-2017).pdf Документация как код в промышленных масштабах (Николай Волынкин, SECR-2017).pdf Документация как код в промышленных масштабах (Николай Волынкин, SECR-2017).pdf Документация как код в промышленных масштабах (Николай Волынкин, SECR-2017).pdf Документация как код в промышленных масштабах (Николай Волынкин, SECR-2017).pdf Документация как код в промышленных масштабах (Николай Волынкин, SECR-2017).pdf Документация как код в промышленных масштабах (Николай Волынкин, SECR-2017).pdf Документация как код в промышленных масштабах (Николай Волынкин, SECR-2017).pdf Документация как код в промышленных масштабах (Николай Волынкин, SECR-2017).pdf Документация как код в промышленных масштабах (Николай Волынкин, SECR-2017).pdf Документация как код в промышленных масштабах (Николай Волынкин, SECR-2017).pdf
Документация как код в промышленных масштабах (Николай Волынкин, SECR-2017)!.jpg

Примечания и ссылки


Plays:472   Comments:1