Kako koristiš AI za pisanje tehničke dokumentacije, promjena i poruka commit-a?

Question

Accepted Answer

Ključ je **dati AI sirovinu** — stvarni diff ili kod — i zatražiti određeni, konvencionalan format. AI je dobar u pretvaranju promjene u jasan tekst, ali samo ako može vidjeti što se promijenilo.

## Dobar tijek rada

- **Daj mu diff**, ne nejasan opis: `git diff --staged | <your AI tool>`.
- **Traži poznatu konvenciju** — Conventional Commits (`feat:`, `fix:`, `docs:`), ili tvoj stil promjena.
- **Drži ga točnim i sažetim** — redak naslova ispod ~50 znakova, tekst koji objašnjava *zašto*.
- **Provjeri da se poklapa s diff-om.** AI može izmisliti promjene koje ne postoje; moraš provjeriti.

## Prije / Poslije

JednA lijena poruka commit-a:

```text
fixed stuff
```

Nakon davanja diff-a i zahtijevanja Conventional Commit stila:

```text
fix(auth): reject expired tokens in session middleware

The middleware only checked token signature, not expiry, so expired
sessions stayed valid. Added an `exp` claim check that returns 401.
```

Drugi verzija govori recenzentu *što* se promijenilo i *zašto* — daleko korisnije u `git log` šest mjeseci kasnije.

## U čemu je AI dobar ovdje

- **Docstrings i READMEs** — sažeti svrhu i upotrebu modula.
- **Promjene** — grupiraj commit-e u sekcije Added / Fixed / Changed.
- **Poruke commit-a** — pretvori diff u čistu, konvencionalnu poruku.

Uvijek **čitaj rezultat naspram stvarne promjene**. AI ne zna tvoju namjeru — samo kod koji joj je pokazan — pa može pogrešno etiketirati `fix` kao `feat` ili tvrditi stranični učinak koji zapravo ne postoji.

## Zašto je to važno

Dobre poruke commit-a i dokumentacija su način na koji ti i tvoji suradnici u budućnosti razumijevate *zašto* kod postoji. AI uklanja trenje pisanja na dobar način, ali točnost je na tebi: pouzdano pogrešna lista promjena gora je od ničega. Daj mu stvarni unos, zatraži stvarnu konvenciju i provjeri prije nego što commit-ašš.