Настанови для сталих рішень

https://www.infoq.com/articles/sustainable-architectural-design-decisions/

У своїй роботі ми винесли такі уроки, що можуть правити за настанови та оцінку для досягнення сталих рішень:

1. Для початкового документування рішень використовуйте ощадливий, мінімалістичний підхід.

2. Визначте пріоритети та зафіксуйте всі важливі рішення, достатньо суттєві для документування й розуміння цільової архітектури.

3. Особливо важливі рішення деталізуйте повноцінними шаблонами лише після завершення початкової роботи (тобто коли особи, які ухвалюють рішення, задоволені прийнятими архітектурними рішеннями й упевнені, що ці рішення не доведеться переглядати найближчим часом).

4. Використовуйте ощадливі, мінімалістичні версії з кроку 1 як коротку форму задокументованих рішень із правильним рівнем деталізації, щоб дати огляд детальних рішень, а також для тривіальних чи очевидних рішень.

5. Де лише можливо, використовуйте наявні архітектурні знання — з моделей настанов чи інших джерел. Переглядайте й розширюйте такі знання та підганяйте їх під контекст конкретного рішення.

6. Подбайте, щоб між рішеннями, з одного боку, та вимогами й архітектурними проєктами/кодом, з іншого, були встановлені зв’язки відстежуваності.

7. Забезпечте автоматизовану перевірку узгодженості, щоб після зміни зв’язки відстежуваності лишалися синхронізованими. Обмежте кількість залежностей між рішеннями та іншими програмними артефактами.

8. Послідовно й наполегливо застосовуйте настанови щодо обґрунтувань — це найважливіша частина документації рішення, бо вона дає підстави.