Насоки за постигане на устойчиви решения

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

В работата си научихме следните уроци, които могат да послужат като насоки и оценка за постигане на устойчиви решения:

1. Използвайте облекчен/минималистичен подход за първоначалната документация на решенията.

2. Приоритизирайте и фиксирайте всички важни решения, които са достатъчно съществени, за да бъдат документирани и за да се разбира целевата архитектура.

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

4. Използвайте облекчените/минималистичните версии от стъпка 1 като кратка версия на документираните решения с правилното ниво на детайлност, за да дадете преглед на подробните решения, както и за тривиални или очевидни решения.

5. Където е възможно, използвайте съществуващи архитектурни знания, било от ръководни модели, било от други източници. Прегледайте и разширете такива знания и ги приспособете към контекста на конкретното решение.

6. Уверете се, че са установени връзки за проследимост между решенията и както изискванията, така и архитектурните проекти/код.

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

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