Si i dokumenton vendimet e mëdha teknike?

Question

Accepted Answer

Vendimet e mëdha teknike duhet të jenë **të qëllimshme, transparente dhe të regjistruara**, jo të nxjerra në mendje të dikujt dhe të harruar. Një proces i mirë zbulon kompromiso, ndërton pajtim dhe lë një gjurmë në mënyrë që inxhinierët e ardhshëm të kuptojnë *pse*, jo vetëm *çfarë*.

## Një kornizë për vendimmarrje

```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
```

## Regjistroje me një ADR

Një **Architecture Decision Record** është një shënim i shkurtër dhe qëndrueshëm:

```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).
```

## Kompromiso për të menaxhuar

Dokumentimi i gjithçkaje është tepricë; dokumentimi i asgjëje humb kujtesën institucionale. Mbaji ADRs për vendime që janë **të shtrenjta për të kundërpërdorur** ose që inxhinierët e ardhshëm do të pyesin.

## Pse është i rëndësishëm

Vendimet e padokumentuara rishqyrtohen pa fund, çdo inxhinier i ri pyet "përse zgjodhëm këtë?"

Shkrimi i arsyetimit gjithashtu detyron qartësi: nëse nuk mund ta justifikosh në letër, ndoshta nuk e ke menduar mjaftueshëm.