#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)