Architecture Decision Record

Active theme: Light

← dogfennau

Canllawiau i gyflawni penderfyniadau cynaliadwy

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

Dysgom y gwersi canlynol yn ein gwaith, a gallant fod yn ganllawiau ac yn sail asesu ar gyfer cyflawni penderfyniadau cynaliadwy:

  1. Defnyddiwch ddull main/minimalaidd ar gyfer y ddogfennaeth gychwynnol o benderfyniadau.

  2. Blaenoriaethwch a chofnodwch yr holl benderfyniadau pwysig sy'n ddigon perthnasol i'w dogfennu ac i ddeall y saernïaeth darged.

  3. Manylwch ar y penderfyniadau sy'n arbennig o bwysig gan ddefnyddio templedi llawn, ond dim ond ar ôl i'r gwaith cychwynnol gael ei wneud (hynny yw, pan fydd y penderfynwyr yn fodlon â'r penderfyniadau a wnaed ynghylch saernïaeth ac yn hyderus nad oes angen eu hadolygu'n fuan).

  4. Defnyddiwch y fersiynau main/minimalaidd o gam 1 fel fersiwn gryno o'r penderfyniadau dogfenedig, ar y lefel manylder briodol, i roi trosolwg o'r penderfyniadau manwl, ac ar gyfer penderfyniadau dibwys neu amlwg.

  5. Pan fo'n bosibl, defnyddiwch wybodaeth am saernïaeth sy'n bodoli eisoes, boed o fodelau canllaw neu o ffynonellau eraill. Adolygwch ac ehangwch wybodaeth o'r fath a'i haddasu i gyd-destun y penderfyniad penodol.

  6. Sicrhewch fod dolenni olrhain yn cael eu sefydlu rhwng penderfyniadau a gofynion, a hefyd rhwng penderfyniadau a dyluniadau/cod saernïaeth.

  7. Darparwch wiriadau cysondeb awtomataidd i sicrhau bod y dolenni olrhain yn cyd-fynd â'i gilydd ar ôl newid. Cyfyngwch nifer y dibyniaethau rhwng penderfyniadau ac arteffactau meddalwedd eraill.

  8. Defnyddiwch y canllawiau ar gyfer y cyfiawnhad yn gyson ac yn bendant—dyma ran bwysicaf y ddogfennaeth penderfyniadau oherwydd mai dyma sy'n rhoi'r sail resymegol.