DotNet & More
#37 выпуск подкаста DotNet&More: Документация, UML и не только
Её сложно найти, легко потерять и невозможно забыть. Конечно же мы имеем в виду документацию. На SpbDotNet Meetup нам не хватило времени на то, чтобы обсудить все, так что мы решили продолжить в нашем подкасте.
Мы часто экспериментируем и нам очень важно Ваше мнение. Поделитесь им с нами в опросе: https://forms.gle/WCUw6pzxFUCRwT8H6
Спасибо всем кто нас слушает. Не стесняйтесь оставлять обратную связь и предлагать свои темы.
Shownotes:
- [0:04:17] ADR
- [0:11:56] 3 правила написания хорошего документа
- [0:15:29] Учимся писать документацию
- [0:18:40] Канцелярит
- [0:20:46] Documentation Review
- [0:32:50] Аналогия с дипломными работами
- [0:42:16] Классификация
- [0:48:50] Комментарии в коде
- [1:00:50] UML
- [1:07:20] BPMN
- [1:13:55] No Code
- [1:20:54] Советы
Ссылки:
- https://community-z.com/events/escape/agenda: ESCAPE Conference
- https://youtu.be/94cJU14qkis : Кулаков, Кугушев, Акуляков, Мерсон, Данилов «Круглый стол: Документируй это полностью»
- https://adr.github.io/madr/ : Markdown Architectural Decision Records
- https://plantuml.com/activity-diagram-beta : Activity Diagram (plantuml)
- https://c4model.com/ : C4 model
- https://sparxsystems.com/enterprise_architect_user_guide/15.1/model_simulation/bpmn_simulation_comparison.html : Comparison of UML Activities and BPMN Processes
- https://youtu.be/Z5o0PbWDzJM : T4 и DSL Tools или наш опыт использования Model Driven Architecture (MDA)