Architecture Decision Record

Active theme: Light

← документи

Як почати користуватися ADR

Щоб почати користуватися ADR, обговоріть із колегами такі напрями.

Визначення рішень:

  • Наскільки термінове й наскільки важливе це AD?

  • Чи його потрібно ухвалити зараз, чи можна зачекати, поки з’явиться більше знань?

  • Допомогти у визначенні рішень можуть і особистий та колективний досвід, і визнані методи та практики проєктування.

  • В ідеалі ведіть список рішень, які потрібно ухвалити, що доповнює список завдань продукту.

Ухвалення рішень:

  • Існує чимало технік ухвалення рішень — як загальних, так і специфічних для архітектури програмного забезпечення, наприклад, картографування діалогу (dialogue mapping).

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

Запровадження та дотримання рішень:

  • AD використовуються під час проєктування програмного забезпечення; тому їх потрібно доносити до зацікавлених сторін системи, які її фінансують, розробляють і експлуатують, та отримувати їхнє схвалення.

  • Дві пов’язані практики — архітектурно очевидні стилі кодування та рев’ю коду, зосереджені на архітектурних питаннях і рішеннях.

  • AD також потрібно (пере)розглядати під час модернізації програмної системи в процесі її еволюції.

Поширення рішень (необов’язково):

  • Багато AD повторюються в різних проєктах.

  • Тому досвід минулих рішень, і вдалих, і невдалих, може бути цінним повторно використовуваним активом, якщо застосовувати явну стратегію управління знаннями.

Документування рішень:

  • Існує багато шаблонів та інструментів для фіксації рішень.

  • Див. гнучкі (agile) спільноти, наприклад, ADR за М. Найгардом.

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

Докладніше: