آپ اہم تکنیکی فیصلے کیسے کرتے اور دستاویز کرتے ہیں؟

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 کو صرف ان فیصلوں کے لیے محفوظ رکھیں جو **الٹانے میں مہنگے** ہیں یا جن پر مستقبل کے انجینئرز سوال کریں گے۔

## اہم کیوں ہے

غیر دستاویز شدہ فیصلے بے انتہا دوبارہ بحث کا نشانہ بنتے ہیں، ہر نیا انجینئر "ہم نے یہ کیوں منتخب کیا؟" دوبارہ پوچھتا ہے۔

استدلال کو کاغذ پر لکھنا وضاحت کو بھی مجبور کرتا ہے: اگر آپ اسے کاغذ پر جواز دہی نہیں کر سکتے، تو آپ نے شاید اس پر مناسب طریقے سے غور نہیں کیا۔