Её сложно найти, легко потерять и невозможно забыть. Конечно же мы имеем в виду документацию. На 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)