vitrinkaDokumentaceZpět do vitrínky

Psaní

Dokumentace, architektura, stránky a rozhodnutí o návrhu — skilly, které píšou, místo aby opravovaly.

/vitrinka:docs

Promění repozitář v živou dokumentační nástěnku: najde zdroje pravdy — docker-compose, OpenAPI, SQL DDL, migrace — založí nástěnku, importuje každý diagram do jeho sekce, napíše stránky a propojí odkazy oběma směry.

/vitrinka:diagram

Složí jeden architektonický diagram, buď z pravdy v repozitáři, nebo ze systému, který popíšete. Posíláte význam — dráhy, skupiny, typované uzly, porty, hrany — a rozvrhne to server.

Souřadnice neposíláte nikdy. Rozvržení se počítá, takže přidání uzlu obrázek nerozbije.

/vitrinka:pages

Píše a udržuje stránky jako markdown. Stránka navázaná na soubor v repozitáři nese zdroj i revizi, obnoví se po úpravách a dá se zapsat zpátky do souboru a commitnout.

/vitrinka:brainstorming

Návrh vedený rozhodnutími. Zmapuje rozhodnutí, na kterých opravdu záleží, předloží je jako dávku voleb s doporučením u každé a skončí zapsaným rozhodovacím logem — a pak z něj staví.

/vitrinka:recall

Paměťový průchod před stavbou. Než začnete navrhovat nebo předělávat obrazovku, vytáhne, co už vitrinka ví: paměť projektu, starší snímky té obrazovky a indexovaný slovník komponent.

Existuje proto, aby se nestavělo znovu od nuly.

/vitrinka:release

Řídí release nástěnku projektu přímo z repozitáře — smete slité pull requesty do průběžné nástěnky příštího vydání, nebo vydání vystřihne.