Gairės tvariems sprendimams pasiekti

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

Savo darbe išmokome šių pamokų, kurios gali būti gairės ir vertinimo pagrindas siekiant tvarių sprendimų:

1. Pradiniam sprendimų dokumentavimui naudokite liesą / minimalistinį požiūrį.

2. Nustatykite prioritetus ir užfiksuokite visus svarbius sprendimus, kurie yra pakankamai reikšmingi, kad juos reikėtų dokumentuoti ir suprasti tikslinę architektūrą.

3. Ypač svarbius sprendimus išsamiai aprašykite pilnaverčiais šablonais tik atlikus pradinį darbą (t. y. kai sprendimų priėmėjai yra patenkinti priimtais architektūriniais sprendimais ir tikri, kad šių sprendimų netrukus nereikės peržiūrėti).

4. Liesas / minimalistines 1 žingsnio versijas naudokite kaip trumpą dokumentuotų sprendimų versiją su tinkamu detalumo lygiu, kad būtų galima apžvelgti išsamius sprendimus, taip pat nereikšmingiems ar akivaizdiems sprendimams.

5. Kai tik įmanoma, naudokite esamas architektūros žinias, gautas iš vadovavimo modelių ar kitų šaltinių. Peržiūrėkite ir išplėskite tokias žinias bei pritaikykite jas konkretaus sprendimo kontekstui.

6. Užtikrinkite, kad tarp sprendimų ir tiek reikalavimų, tiek architektūros projektų / kodo būtų sukurti atsekamumo saitai.

7. Užtikrinkite automatizuotą nuoseklumo tikrinimą, kad po pakeitimo atsekamumo saitai liktų sinchronizuoti. Apribokite sprendimų ir kitų programinės įrangos artefaktų tarpusavio priklausomybių skaičių.

8. Pagrindimo gaires taikykite nuosekliai ir ryžtingai – tai svarbiausia sprendimo dokumentacijos dalis, nes ji pateikia pagrindimą.