Převede aktuální diff na srozumitelné shrnutí pro netechnického recenzenta: rozdělí změny na funkční, obsahové, generované, dokumentační a testové, řekne, které generované soubory jsou důsledkem které změny dat, vyjmenuje rizika a nečekané soubory a přidá konkrétní způsob ověření.
Kdy ho spustit
Před review, před odesláním příspěvku, nebo po delší práci, kdy se ztratil přehled.
Pro koho a s jakým rizikem
- Persona: přispěvatel zdrojem, editor, vývojář, recenzent, údržbář
- Riziko: jen čte
- Zapisuje do souborů: ne
Co vynucuje
Nic — tenhle příkaz reportuje nebo generuje, ale sám o sobě nic neshazuje. Co selže při chybě, hlídají brány, které za ním v pipeline běží.
Co je potřeba vědět
- Rozdělení do kategorií je celý přínos: diff se čtyřiceti soubory vypadá hrozivě, i když je to jedna změna dat.
- Generovaný soubor BEZ odpovídající změny dat je nález, ne šum.
- Řádek JAK OVĚŘIT je povinný. Vysvětlení bez způsobu ověření je žádost o důvěru.
- Nezamlčí soubor proto, že „je to jen generované“.