Применение практики «Документация как код» для документирования заказных приложений (Николай Поташников, SECR-2018) — различия между версиями
Материал из 0x1.tv
StasFomin (обсуждение | вклад) (Новая страница: «;{{SpeakerInfo}}: {{Speaker|Николай Поташников}} <blockquote> Умение создавать хорошую документацию выдел…») |
StasFomin (обсуждение | вклад) (Batch edit: replace PCRE (\n\n)+(\n) with \2) |
||
(не показаны 24 промежуточные версии этого же участника) | |||
Наш 20-летний опыт создания заказных приложений позволяет с уверенностью сказать, что практика «Документация как код» является наилучшей для сокращения усилий при документировании, причем как в маленьких, так и в очень больших проектах с любым уровнем формализации требований. В докладе я расскажу о том, как эта практика применяется у нас в компании. В своей работе мы ориентируемся на технологическую цепочку Asciidoctor, но речь пойдет об общем подходе к процессу подготовки программной документации, его организационной и технологической составляющих. </blockquote> {{VideoSection}} {{vimeoembed|287828465|800|450}} {{youtubelink|}}|gUlfFsxVCFg}} {{letscomment}} {{SlidesSection}} [[File:Применение практики «Документация как код» для документирования заказных приложений (Николай Поташников, SECR-2018).pdf|left|page=-|300px]] {{----}} [[File:{{#setmainimage:Применение практики «Документация как код» для документирования заказных приложений (Николай Поташников, SECR-2018)!.jpg}}|center|640px]] {{LinksSection}} * [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]] [[Категория:Draft]]Документирование]] {{stats|disqus_comments=0|refresh_time=2021-08-31T18:01:02.803995|vimeo_plays=174|youtube_comments=0|youtube_plays=236}} |
Текущая версия на 12:22, 4 сентября 2021
- Докладчик
- Николай Поташников
Умение создавать хорошую документацию выделяет разработчика среди конкурентов. Умение создавать документацию эффективно, не затрачивая больших усилий, не так заметно, но не менее важно, особенно если создается сложный программный продукт, а заказчик оказался требовательным.
Наш 20-летний опыт создания заказных приложений позволяет с уверенностью сказать, что практика «Документация как код» является наилучшей для сокращения усилий при документировании, причем как в маленьких, так и в очень больших проектах с любым уровнем формализации требований. В докладе я расскажу о том, как эта практика применяется у нас в компании.
В своей работе мы ориентируемся на технологическую цепочку Asciidoctor, но речь пойдет об общем подходе к процессу подготовки программной документации, его организационной и технологической составляющих.
Видео
Посмотрели доклад? Понравился? Напишите комментарий! Не согласны? Тем более напишите.
Презентация
Примечания и ссылки
Plays:410 Comments:0