Wytyczne dla trwałych decyzji

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

W naszej pracy wyciągnęliśmy następujące wnioski, które mogą służyć jako wytyczne i ocena osiągania trwałych decyzji:

1. Do wstępnej dokumentacji decyzji użyj podejścia szczupłego/minimalistycznego.

2. Nadaj priorytet i opisz wszystkie ważne decyzje, które są na tyle istotne, by je dokumentować i by zrozumieć architekturę docelową.

3. Szczególnie ważne decyzje opisuj szczegółowo pełnymi szablonami dopiero po zakończeniu wstępnej pracy (czyli gdy decydenci są zadowoleni z podjętych decyzji architektonicznych i pewni, że nie trzeba będzie ich wkrótce zmieniać).

4. Wersje szczupłe/minimalistyczne z kroku 1 wykorzystaj jako krótką wersję udokumentowanych decyzji, o odpowiednim poziomie szczegółowości, która daje przegląd decyzji szczegółowych, a także jako zapis decyzji trywialnych lub oczywistych.

5. Wszędzie, gdzie to możliwe, korzystaj z istniejącej wiedzy architektonicznej, pochodzącej z modeli wytycznych lub z innych źródeł. Przejrzyj i rozszerz taką wiedzę oraz dopasuj ją do kontekstu konkretnej decyzji.

6. Zadbaj o powiązania identyfikowalności między decyzjami a wymaganiami oraz projektami architektury/kodem.

7. Zapewnij zautomatyzowane sprawdzanie spójności, aby powiązania identyfikowalności pozostawały zsynchronizowane po zmianie. Ogranicz liczbę zależności między decyzjami a innymi artefaktami oprogramowania.

8. Stosuj wytyczne dotyczące uzasadnień konsekwentnie i stanowczo — to najważniejsza część dokumentacji decyzji, ponieważ wyjaśnia przyczyny.