Sprendimo įrašo šablonas svarbiems techniniams sprendimams (ITD)

Tai svarbių techninių sprendimų (ITD) šablonas, aprašytas straipsnyje ITDs: a lean ADR for executive technical decision-making at scale - Ignacio Larrañaga.

ITD yra tikslinė ADR evoliucija, optimizuota greičiui, aiškumui ir vadovų patvirtinimui. Kai ADR dokumentuoja tai, kas buvo nuspręsta, ITD yra liesas, pirmiausia sprendimą pateikiantis artefaktas, leidžiantis peržiūrėti patį sprendimą, kad suinteresuotieji asmenys galėtų jį greitai peržvelgti ir lengvai ginčyti. ITD gerai tinka techniniams sprendimams, kurie nėra griežtai architektūriniai, pavyzdžiui, modelio, bibliotekos ar CI/CD strategijos pasirinkimui.

Kiekviename ITD faile parašykite šiuos skyrius:

Pavadinimas

Nurodykite patį sprendimą, o ne temos aprašą. Pavyzdžiui, „Naudoti Qwen2.5 1.5B Instruct vertimui įrenginyje“.

Problema

Vienas sakinys, nurodantis, ką siekiame išspręsti.

Svarstyti variantai

Alternatyvos, kurios buvo svarstomos, pasirinktą variantą pažymint paryškintu šriftu.

Pagrindimas

Tik lemiami veiksniai, nulėmę pasirinkimą, o ne išsamus kiekvieno privalumo ir trūkumo sąrašas.

Pastabos

Neprivaloma. Bet koks papildomas kontekstas, kurį verta užfiksuoti, pavyzdžiui, apribojimai, prielaidos ar nuorodos.