Irányelvek a fenntartható döntésekhez

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

Munkánk során a következő tanulságokat vontuk le, amelyek irányelvként és értékelésként szolgálhatnak a fenntartható döntések eléréséhez:

1. Használjon karcsú/minimalista megközelítést a kezdeti döntésdokumentációhoz.

2. Rangsorolja és rögzítse az összes fontos döntést, amely elég releváns a célarchitektúra dokumentálásához és megértéséhez.

3. A különösen fontos döntéseket csak a kezdeti munka elvégzése után részletezze teljes értékű sablonokkal (vagyis amikor a döntéshozók elégedettek a meghozott architekturális döntésekkel, és biztosak abban, hogy ezeket a döntéseket egyhamar nem kell felülvizsgálni).

4. Használja az 1. lépés karcsú/minimalista változatait a dokumentált döntések rövid változataként, megfelelő szemcsézettségi szinten, hogy áttekintést adjanak a részletes döntésekről, valamint a triviális vagy nyilvánvaló döntésekhez.

5. Ahol csak lehetséges, használjon meglévő architekturális tudást, akár útmutatómodellekből, akár más forrásokból. Vizsgálja felül és bővítse ezt a tudást, és illessze az adott döntés kontextusához.

6. Gondoskodjon arról, hogy a döntések és a követelmények, valamint az architekturális tervek/kód között nyomonkövethetőségi hivatkozások legyenek kialakítva.

7. Biztosítson automatizált konzisztenciaellenőrzést, hogy a nyomonkövethetőségi hivatkozások módosítás után is szinkronban maradjanak. Korlátozza a döntések és más szoftverartefaktumok közötti függőségek számát.

8. Alkalmazza az indoklásokra vonatkozó irányelveket következetesen és határozottan — ezek a döntésdokumentáció legfontosabb részei, mert ők adják az indokot.