Architecture Decision Record

Active theme: Light

← nyaraka

Mapendekezo ya kuandika ADR nzuri

Sifa za ADR nzuri:

  • Sababu: Eleza sababu za kufanya AD mahsusi. Hii inaweza kujumuisha muktadha (tazama hapa chini), faida na hasara za chaguo mbalimbali zinazowezekana, ulinganisho wa vipengele, mijadala ya gharama/faida, na zaidi.

  • Mahsusi: Kila ADR inapaswa kuhusu AD moja, si AD nyingi.

  • Mihuri ya muda: Tambua wakati kila kipengele katika ADR kinapoandikwa. Hii ni muhimu hasa kwa vipengele vinavyoweza kubadilika kwa muda, kama gharama, ratiba, upanuzi, na vinavyofanana na hivyo.

  • Isiyobadilika: Usibadilishe taarifa zilizopo katika ADR. Badala yake, rekebisha ADR kwa kuongeza taarifa mpya, au iondoe nafasi kwa kuunda ADR mpya.

Sifa za sehemu nzuri ya "Muktadha" katika ADR:

  • Eleza hali ya shirika lako na vipaumbele vya biashara.

  • Jumuisha sababu na mazingatio kulingana na muundo wa kijamii na ujuzi wa timu zako.

  • Jumuisha faida na hasara zinazohusika, na uzieleze kwa maneno yanayolingana na mahitaji na malengo yako.

Sifa za sehemu nzuri ya "Matokeo" katika ADR:

  • Eleza kinachofuata kutokana na kufanya uamuzi. Hii inaweza kujumuisha athari, matokeo, pato, ufuatiliaji, na zaidi.

  • Jumuisha taarifa kuhusu ADR zozote zinazofuata. Ni jambo la kawaida kiasi kwamba ADR moja huchochea hitaji la ADR zaidi, kama ADR moja inapofanya chaguo kubwa la kuvuka mipaka, ambalo nalo huunda mahitaji ya maamuzi madogo zaidi.

  • Jumuisha michakato yoyote ya mapitio baada ya kitendo. Ni kawaida kwa timu kupitia kila ADR mwezi mmoja baadaye, kulinganisha taarifa za ADR na kilichotokea katika utendaji halisi, ili kujifunza na kukua.

ADR mpya inaweza kuchukua nafasi ya ADR ya awali:

  • Wakati AD inapofanywa inayochukua nafasi au kubatilisha ADR ya awali, basi ADR mpya inapaswa kuundwa