Ohjeet kestävien päätösten saavuttamiseen

Opimme työssämme seuraavat opit, jotka voivat toimia ohjeina ja arviointiperusteina kestävien päätösten saavuttamiseksi:

Käytä kevyttä/minimalistista lähestymistapaa päätösten alustavassa dokumentoinnissa.
Priorisoi ja kirjaa kaikki tärkeät päätökset, jotka ovat riittävän olennaisia kohdearkkitehtuurin dokumentointia ja ymmärtämistä varten.
Kuvaile erityisen tärkeät päätökset täysimittaisilla mallipohjilla vasta alkuvaiheen työn jälkeen (eli kun päätöksentekijät ovat tyytyväisiä tehtyihin arkkitehtuuripäätöksiin ja luottavat siihen, ettei näitä päätöksiä tarvitse tarkistaa piakkoin).
Käytä vaiheen 1 kevyitä/minimalistisia versioita dokumentoitujen päätösten lyhyenä versiona oikealla tarkkuustasolla antamaan yleiskuva yksityiskohtaisista päätöksistä sekä triviaaleja tai ilmeisiä päätöksiä varten.
Käytä aina kun mahdollista olemassa olevaa arkkitehtuuritietoa, joko ohjemalleista tai muista lähteistä. Katselmoi ja laajenna tällaista tietoa ja sovita se kyseisen päätöksen kontekstiin.
Varmista, että päätösten ja sekä vaatimusten että arkkitehtuurisuunnitelmien/koodin välille luodaan jäljitettävyyslinkit.
Tarjoa automaattinen johdonmukaisuustarkistus varmistamaan, että jäljitettävyyslinkit pysyvät synkronissa muutoksen jälkeen. Rajoita päätösten ja muiden ohjelmistoartefaktien välisten riippuvuuksien määrää.
Noudata perusteluja koskevia ohjeita johdonmukaisesti ja tinkimättömästi — ne ovat päätösdokumentaation tärkein osa, koska ne antavat perustelut.