Применение практики «Документация как код» для документирования заказных приложений (Николай Поташников, SECR-2018) — различия между версиями
Материал из 0x1.tv
StasFomin (обсуждение | вклад) |
StasFomin (обсуждение | вклад) |
||
* [https://2018.secrus.org/program/submitted-presentations/applying-documentation-as-code-practice/ Talks page on SECR site] <!-- <blockquote>[©]</blockquote> --> {{fblink|2191158167803859}} {{vklink|1315}} <references/> <!-- topub --> [[Категория:SECR-2018]] [[Категория:Документирование]] {{stats|disqus_comments=0|refresh_time=2020-07-19T00:04:492021-08-25T03:27:37.913140006554|vimeo_plays=65174|youtube_comments=0|youtube_plays=111}}236}} |
Версия 00:27, 25 августа 2021
- Докладчик
- Николай Поташников
Умение создавать хорошую документацию выделяет разработчика среди конкурентов. Умение создавать документацию эффективно, не затрачивая больших усилий, не так заметно, но не менее важно, особенно если создается сложный программный продукт, а заказчик оказался требовательным.
Наш 20-летний опыт создания заказных приложений позволяет с уверенностью сказать, что практика «Документация как код» является наилучшей для сокращения усилий при документировании, причем как в маленьких, так и в очень больших проектах с любым уровнем формализации требований. В докладе я расскажу о том, как эта практика применяется у нас в компании.
В своей работе мы ориентируемся на технологическую цепочку Asciidoctor, но речь пойдет об общем подходе к процессу подготовки программной документации, его организационной и технологической составляющих.
Видео
Посмотрели доклад? Понравился? Напишите комментарий! Не согласны? Тем более напишите.
Презентация
Примечания и ссылки
Plays:410 Comments:0