તમે મહત્વપૂર્ણ તકનીકી નિર્ણયો કેવી રીતે લો અને દસ્તાવેજ કરો?

Question

Accepted Answer

મહત્વપૂર્ણ તકનીકી નિર્ણયો **ધિરાણ પૂર્વક, સ્પષ્ટ અને રેકોર્ડ કરેલા** હોવા જોઈએ, કોઈના મનમાં લીધા અને ભૂલાઈ જવા જોઈએ નહીં. એક સારી પ્રક્રિયા ટ્રેડ-ઑફ્સ, સહમતિ બનાવે છે, અને ભવિષ્યના ઇજનેરોને તે સમજાય છે કે *શું*, માત્ર *કેમ* નહીં.

## નિર્ણય માટે ફ્રેમવર્ક

```text
1. FRAME the problem and the constraints (cost, time, team skill, scale)
2. LIST the realistic options — usually 2-4, including "do nothing"
3. EVALUATE each against the constraints and trade-offs
4. DECIDE, and state the reasoning explicitly
5. RECORD it (ADR) and communicate it
6. REVISIT if assumptions change
```

## તેને ADR સાથે રેકોર્ડ કરો

एક **Architecture Decision Record** એક ટૂંકો, સ્થાયી નોંધ છે:

```markdown
# ADR 014: Use PostgreSQL for the new service

## Status: Accepted

## Context
We need a primary datastore. Team knows SQL; data is relational; scale is moderate.

## Decision
Use PostgreSQL.

## Consequences
+ Strong consistency, team familiarity, rich querying.
- Vertical scaling limits later; revisit if write volume 10x's.

## Alternatives considered
DynamoDB (rejected: relational data, team unfamiliar).
```

## તે વેપાર-ઑફ માટે વ્યવસ્થાપિત કરવા માટે

સૌ કંઈને દસ્તાવેજ કરવું ઉપરિ છે; કંઈ પણ દસ્તાવેજ ન કરવાથી સંસ્થાગત સ્મૃતિ ખોવાય છે. ADRs ને નિર્ણયો માટે આરક્ષિત રાખો જે **રિવર્સ કરવા માટે મર્યાદાશીલ** છે અથવા જેને ભવિષ્યના ઇજનેરો પ્રશ્ન કરશે.

## આ શા માટે મહત્વપૂર્ણ છે

અદસ્તાવેજિત નિર્ણયો સતત પુનરાવર્તિત થાય છે, દરેક નવા ઇજનેર પૂછે છે "આપણે આ શા માટે પસંદ કર્યું?"

તર્ક લખવું પણ સ્પષ્ટતા બાધ્ય કરે છે: જો તમે તેને કાગળ પર વાજબી ઠેરવી શકતા નથી, તો તમે સંભવતઃ તેના વિશે વિચાર્યું નથી.