Architecture Decision Record

Active theme: Light

← документы

Как начать использовать ADR

Чтобы начать использовать ADR, обсудите с коллегами следующие области.

Выявление решений:

  • Насколько срочно и насколько важно AD?

  • Нужно ли принимать его сейчас или можно подождать, пока станет известно больше?

  • Выявлению решений могут помочь как личный и коллективный опыт, так и признанные методы и практики проектирования.

  • В идеале ведите список решений к принятию, дополняющий список дел по продукту.

Принятие решений:

  • Существует ряд техник принятия решений, как общих, так и специфичных для архитектуры программного обеспечения, например картирование диалога.

  • Групповое принятие решений — активная тема исследований.

Реализация и обеспечение соблюдения решений:

  • AD используются при проектировании ПО; следовательно, о них нужно сообщать заинтересованным сторонам системы, которые её финансируют, разрабатывают и эксплуатируют, и они должны их принять.

  • Две родственные практики — архитектурно очевидные стили кодирования и проверки кода, сосредоточенные на архитектурных проблемах и решениях.

  • AD также приходится (пере)рассматривать при модернизации программной системы в ходе эволюции ПО.

Совместное использование решений (необязательно):

  • Многие AD повторяются в разных проектах.

  • Поэтому опыт прошлых решений, как хороший, так и плохой, может быть ценным повторно используемым активом при применении явной стратегии управления знаниями.

Документирование решений:

  • Существует множество шаблонов и инструментов для фиксации решений.

  • Смотрите гибкие сообщества, например ADR М. Найгарда.

  • Смотрите традиционные процессы программной инженерии и проектирования архитектуры, например табличные макеты, предложенные IBM UMF, а также Тайри и Акерманом из CapitalOne.

Подробнее:

  • Приведённые выше шаги взяты из статьи Википедии Architectural Decision