Git Commit Policy

Pravidla pro přispěvatele do Git repositáře.

Odesílejte pouze otestovaný kód

Pečlivě zkontrolujte upravený kód dříve, než jej odešlete. Kód nesmí generovat žádné chyby, ani úrovně E_STRICT. Ověřte všechny jednotkové testy.

Dvakrát měř, jednou odesílej

Zkontrolujte, jaké změny skutečně odesíláte. Před odesláním zkontrolujte diff všech souborů. Ujistěte se, že všechny nově přidané soubory byly odeslány také.

Odesílejte kompletní dávky

Každý bugfix, nová vlastnost, refactoring jdoucí přes více souborů musí být odeslán v jedné dávce.

Typografické a formátovací úpravy odesílejte v samostatných dávkách.

Je vhodné, aby dávky byly atomické, nedělitelné.

Dodržujte jmenné konvence a formát souborů

(Specifikace jmenných konvenci a formátování bude doplněna).

Kód nesmí obsahovat znaky mimo rozsah \t\r\n\x20..\x7E.

Pro levostranné odsazování používejte pouze tabulátory (nesmí se míchat s mezerami). Kód nesmí obsahovat pravostranné bílé znaky.

Vždy připojte dostatečně popisnou zprávu

Popisné zprávy uvozujte pomlčkou a začínejte malým písmenem (pokud první slovo není třeba název třídy).

Neodesílejte kód, kterému nerozumíte

Nikdy neodesílejte opravy jen proto, že „vám fungují“. Opravujte chyby jen tehdy, pokud jejich příčině přesně rozumíte a jste si kódem opravy zcela jisti.

---