Conas a dhéanann tú cinneadh teicniúil suntasach agus conas a dhocúmeanann tú iad?

Question

Accepted Answer

Ba cheart go mbeadh cinneadh teicniúil suntasach **fúinscothach, soiléir agus taifead déanta air**, seachas a bheith déanta i gceann duine éigin agus a bheith dearmadta. Soláthraíonn próiseas maith na dtáirbhí a bhreiseadh ar a chéile, tógann sé tacaíocht, agus fágann sé rian ionas go dtuigfidh innealtóirí sa todhchaí *cén fáth*, ní hamháin *cad*.

## Creat cinneadh

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

## Taifead a dhéanamh air le ADR

Is nóta gearr, seasmhach a bhí i **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).
```

## An tsainchomhair a bhainistiú

Bheith ag documented gach rud ina bharr oibre; gan rud ar bith a documented a chailleadh cuimhne institiúideach. Glac ADRanna le haghaidh cinneadh atá **costasach a bhaint ar ais** nó a bheidh innealtóirí sa todhchaí ag ceistiú.

## Cén fáth a bhfuil sé tábhachtach

Bítear ag athlitigiú cinneadh neamhdhocúmeanaithe i gcónaí, agus bíonn gach innealtóir nua ag fiafraí "cén fáth a roghnaigh muid seo?"

Bheith ag scríobh an réasúnaíochta síos tugann soiléireacht: mura féidir leat a bhreithniú ar pháipéar, is dócha nach bhfuil tú smaointe sé trí.