RFC уже вспоминали. PDR тоже. Давайте теперь и ADR вспомним.

Architecture Decision Record (ADR) - это документ, который описывает принятое командой решение об архитектуре системы, которую команда планирует разработать/доработать.

Вот пару интересных ссылок, которые можно изучить, если вы впервые увидели эту аббревиатуру:
• ADR процесс от AWS
• ADR гайд от GitHub
• ADR overview от GCP

Ещё есть разные мнения на тему того, где начинается ADR. Одни считают, что ADR начинается тогда, когда вы уже приняли решение и нужно его где-то зафиксировать. А все обсуждения до этого ведутся где-то ещё (на встречах, в чате, на маркерной доске, в RFC). Другие считают, что ADR начинается с момента, когда вам понадобилось принять архитектурное решение и все дальнейшие обсуждения и выборы должны быть в рамках ADR.

На самом деле не так важно кто прав. Важно то, что и те и другие документируют принимаемые архитектурные решения, а значит они смотрят разные варианты, обсуждают, обдумывают, принимают или отвергают. И всё это вместе, как команда.

Понятно, что для различных PoC или MVP, которые могут быть похоронены ещё на старте, нет большого смысла инвестировать время в ADR. Но этим точно нужно заниматься чем раньше, тем лучше.

#article #link #thought