Architecture Decision Record

Active theme: Light

← dokumentit

Ehdotuksia hyvien ADR-tietueiden kirjoittamiseen

Hyvän ADR-tietueen ominaisuudet:

  • Perustelut: Selitä syyt kyseisen AD-päätöksen tekemiselle. Tähän voi kuulua konteksti (katso alla), eri vaihtoehtojen hyvät ja huonot puolet, ominaisuusvertailut, kustannus–hyöty-keskustelut ja paljon muuta.

  • Täsmällinen: Jokaisen ADR-tietueen tulisi koskea yhtä AD-päätöstä, ei useita.

  • Aikaleimat: Merkitse, milloin kukin ADR-tietueen kohta on kirjoitettu. Tämä on erityisen tärkeää seikoille, jotka voivat muuttua ajan myötä, kuten kustannukset, aikataulut, skaalautuminen ja vastaavat.

  • Muuttumaton: Älä muuta ADR-tietueessa jo olevaa tietoa. Sen sijaan täydennä ADR-tietuetta lisäämällä uutta tietoa tai korvaa ADR-tietue luomalla uusi ADR-tietue.

Hyvän "Konteksti"-osion ominaisuudet ADR-tietueessa:

  • Selitä organisaatiosi tilanne ja liiketoiminnan prioriteetit.

  • Sisällytä perustelut ja huomiot, jotka perustuvat tiimiesi sosiaaliseen koostumukseen ja osaamiseen.

  • Sisällytä olennaiset hyvät ja huonot puolet ja kuvaile ne tavalla, joka vastaa tarpeitasi ja tavoitteitasi.

Hyvän "Seuraukset"-osion ominaisuudet ADR-tietueessa:

  • Selitä, mitä päätöksen tekemisestä seuraa. Tähän voi kuulua vaikutukset, tulokset, tuotokset, jatkotoimet ja paljon muuta.

  • Sisällytä tietoa mahdollisista myöhemmistä ADR-tietueista. On suhteellisen tavallista, että yksi ADR-tietue synnyttää tarpeen useammille ADR-tietueille, esimerkiksi kun yksi ADR-tietue tekee ison kattavan valinnan, joka puolestaan synnyttää tarpeen useille pienemmille päätöksille.

  • Sisällytä mahdolliset jälkikäteisarviointiprosessit. On tavallista, että tiimit arvioivat jokaisen ADR-tietueen kuukauden kuluttua verratakseen ADR-tietueen tietoja siihen, mitä käytännössä on tapahtunut, oppiakseen ja kehittyäkseen.

Uusi ADR-tietue voi korvata aiemman ADR-tietueen:

  • Kun tehdään AD, joka korvaa tai mitätöi aiemman ADR-tietueen, tulisi luoda uusi ADR-tietue