Architecture Decision Record

Active theme: Light

← dokumento

Mga mungkahi sa pagsulat ng mahusay na ADR

Mga katangian ng mahusay na ADR:

  • Rasyonal: Ipaliwanag ang mga dahilan sa paggawa ng partikular na AD. Maaari itong magsama ng konteksto (tingnan sa ibaba), mga pakinabang at disbentaha ng iba't ibang posibleng pagpipilian, paghahambing ng mga feature, talakayan ng gastos/benepisyo, at iba pa.

  • Tiyak: Dapat tungkol sa isang AD lamang ang bawat ADR, hindi sa maraming AD.

  • Mga timestamp: Tukuyin kung kailan isinulat ang bawat bagay sa ADR. Lalo itong mahalaga para sa mga aspetong maaaring magbago sa paglipas ng panahon, tulad ng mga gastos, iskedyul, pag-scale, at iba pang katulad.

  • Hindi nababago: Huwag baguhin ang umiiral na impormasyon sa isang ADR. Sa halip, susugan ang ADR sa pamamagitan ng pagdaragdag ng bagong impormasyon, o palitan ang ADR sa pamamagitan ng paggawa ng bagong ADR.

Mga katangian ng mahusay na seksyong "Konteksto" sa isang ADR:

  • Ipaliwanag ang sitwasyon ng iyong organisasyon at ang mga prayoridad sa negosyo.

  • Isama ang rasyonal at mga konsiderasyong batay sa panlipunang pagkakabuo at mga kasanayan ng iyong mga koponan.

  • Isama ang mga pakinabang at disbentaheng may kaugnayan, at ilarawan ang mga ito sa mga terminong umaayon sa iyong mga pangangailangan at layunin.

Mga katangian ng mahusay na seksyong "Mga Kahihinatnan" sa isang ADR:

  • Ipaliwanag kung ano ang kasunod ng paggawa ng desisyon. Maaari itong magsama ng mga epekto, kalalabasan, output, follow-up, at iba pa.

  • Isama ang impormasyon tungkol sa anumang kasunod na mga ADR. Medyo karaniwan na nagiging dahilan ang isang ADR para kailanganin ang mas maraming ADR, tulad ng kapag gumawa ang isang ADR ng malaking pangkalahatang pagpili, na lumilikha naman ng pangangailangan para sa mas maraming mas maliliit na desisyon.

  • Isama ang anumang proseso ng after-action review. Karaniwan sa mga koponan na repasuhin ang bawat ADR pagkalipas ng isang buwan, para ihambing ang impormasyon sa ADR sa nangyari sa aktwal na pagsasanay, upang matuto at umunlad.

Maaaring pumalit ang bagong ADR sa naunang ADR:

  • Kapag may ginawang AD na pumapalit o nagpapawalang-bisa sa naunang ADR, dapat gumawa ng bagong ADR