Architecture Decision Record

Active theme: Light

← documente

Ghid pentru decizii sustenabile

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

Am învățat următoarele lecții în activitatea noastră, care pot servi drept ghid și evaluare pentru obținerea unor decizii sustenabile:

  1. Folosește o abordare suplă/minimalistă pentru documentarea inițială a deciziilor.

  2. Stabilește prioritățile și consemnează toate deciziile importante care sunt suficient de relevante pentru a documenta și a înțelege arhitectura țintă.

  3. Detaliază deciziile deosebit de importante cu șabloane complete doar după ce lucrul inițial a fost încheiat (adică atunci când factorii de decizie sunt mulțumiți de deciziile arhitecturale luate și încrezători că aceste decizii nu vor trebui revizuite în curând).

  4. Folosește versiunile suple/minimaliste din pasul 1 ca versiune scurtă a deciziilor documentate, cu nivelul potrivit de granularitate, pentru a oferi o privire de ansamblu asupra deciziilor detaliate, precum și pentru deciziile triviale sau evidente.

  5. Oriunde este posibil, folosește cunoștințele arhitecturale existente, fie din modele de ghidare, fie din alte surse. Analizează și extinde aceste cunoștințe și adaptează-le la contextul deciziei concrete.

  6. Asigură-te că între decizii și atât cerințe, cât și proiectări arhitecturale/cod există legături de trasabilitate.

  7. Oferă verificare automată a consistenței pentru a te asigura că legăturile de trasabilitate rămân sincronizate după o modificare. Limitează numărul de dependențe dintre decizii și alte artefacte software.

  8. Aplică ghidurile pentru justificări consecvent și ferm — sunt cea mai importantă parte a documentării deciziilor, pentru că oferă motivația.