Příručka

Pojmy

Kanonické definice pojmů. Vlastní je sekce Koncepty — příručka na ně odkazuje a přidává kontext, kdy se který pojem použije.

Kanonické znění je jinde — otevřít

Postupy

Jak něco udělat, krok za krokem. Od ověření tvrzení po spuštění projektu lokálně.

• 5 min Jak ověřit tvrzení Šest kroků od tvrzení na webu k vlastnímu závěru, jestli sedí. Postup pro čtenáře i pro kontrolu před publikací.
• 4 min Jak poznat převzatý zdroj Šest signálů, podle kterých se pozná, že text přebírá cizí materiál — a co z toho plyne pro nezávislost.
• 4 min Jak poslat nový zdroj Co vyplnit ve formuláři, aby se zdroj dal použít hned, a jak najít tvrzení, kterým druhý doklad opravdu pomůže.
• 4 min Jak navrhnout mezeru Mezera je zodpověditelná otázka s uvedením, kde se hledalo. Jak ji zformulovat, aby byla zadáním, ne povzdechem.
• 4 min Jak nahlásit chybu Který formulář na co, čtyři věci, které musí hlášení obsahovat, a co se s ním stane dál.
• 5 min Jak zkontrolovat rozsah Než začnete psát o někom novém: tři otázky testu veřejného zájmu a rozdíl mezi zaznamenáním vazby a publikací tvrzení.
• 4 min Jak spustit projekt lokálně Od klonu k běžícímu webu čtyřmi příkazy. Technický postup — pro příspěvek přes formulář ho nepotřebujete.
• 4 min Jak validovat a sestavit Který příkaz kdy: rychlá kontrola jednoho záznamu, kontrola bez sestavení, a kanonická brána, která musí projít před odesláním.

Reference

Stručné přehledy k dohledání: stavy, konvence identifikátorů, povinná pole, příkazy, routy.

• 3 min Reference: stavy tvrzení Pět stavů v tabulce — co znamenají, co neznamenají a které z nich vynucuje validátor.
• 4 min Reference: identifikátory a adresy Jak vypadají identifikátory záznamů, proč mají dvě podoby a jaký je vztah mezi lokálním číslem a globální identitou.
• 5 min Reference: povinná pole záznamů Co musí obsahovat záznam tvrzení, zdroje, mezery a entity. Závazný je vždy soubor schématu — tohle je rychlý přehled.
• 4 min Reference: rozložení repozitáře Kde co bydlí, co je generované a co se verzuje. Mapa pro první orientaci v adresářové struktuře.

Řešení problémů

Konkrétní chyba → co znamená, proč nastala, jak ji najít, jak opravit a jak jí předejít.

• 8 min Řešení problémů: data a validace Šest nejčastějších pádů validace kanonických dat — co znamenají, jak je najít, jak opravit a jak jim předejít.
• 8 min Řešení problémů: build a šablony Šest pádů, které přijdou až při sestavení nebo po něm — včetně těch, kde chyba není tam, kde se ohlásila.

Časté otázky

Otázky, které web dostává opakovaně — odpovědi odvozené z pravidel projektu, ne z dojmu.

• 9 min Časté otázky Patnáct otázek, které web dostává opakovaně — od „rozhoduje vomaste.cz, kdo má pravdu?“ po „co když zdroj zmizí?“.

Slovníček

Jednovětá vysvětlení termínů běžnou češtinou, s odkazem na podrobnou stránku.

• 6 min Slovníček Termíny, které web používá, vysvětlené jednou větou běžnou češtinou — s odkazem tam, kde je závazná definice.

Pravidla

Závazná pravidla projektu. Kanonické znění vlastní AGENTS.md a konstituce — tady je čitelný rozcestník.

Kanonické znění je jinde — otevřít