Zdůvodnění
Domovská stránka driftuje po jedné obhajitelné sekci. Tahle dosáhla dvaadvaceti sekcí na celou šířku a 42 229 px při šířce 320 px, než kdokoli rozhodl, že by měla: každá matice, každý argument a každý seznam dostal vlastní pás, každý sám o sobě rozumný, a dohromady byly mapou webu, kterou musel návštěvník přečíst, než se dozvěděl, co produkt je. Jednorázové osekání nezabránilo opakování, protože nic neříkalo, k čemu stránka je.
Totéž platilo o tom, co se ukazovalo vyhledávačům. Z asi tisíce publikovaných rout tři čtvrtiny tvořila auditní stopa repozitáře — jedna stránka na úkol, na schopnost, na relaci — publikovaná ve stejné výšce jako stránky produktu a uvedená ve stejné sitemap, takže hledání produktu našlo nejdřív jeho backlog.
Obojí je podoba, kterou toto repozitář všude jinde odmítá: strukturální rozhodnutí, které nikdo nezapsal, takže by se jím nemohla řídit žádná projekce.
Požadované chování
Sekce domovské stránky se deklarují jednou, jako order v site/data/homepage.toml, a vykreslená stránka je s tímto seznamem držena přesně — nevykreslí se žádná sekce, kterou seznam nejmenuje, žádná jmenovaná sekce nechybí a žádná není mimo pořadí. Každá deklarovaná sekce nese alespoň jeden odkaz nebo jedno odvozené číslo. Domovská stránka neodkazuje žádnou funkci, jejíž stav v modelu produktu není stable. Její sekce instalace nese příkazy instalace, dalšího kroku a ověření, které udává data/registry/distribution.json.
Soupisy produktu, které ukazuje domovská stránka, jsou modelové, v obou směrech. Nástroje workerů, které jmenuje, jsou přesně poskytovatelé data/registry/product.json: ten přidaný do modelu a nevykreslený je zastaralá stránka a ten vykreslený, který model nejmenuje, je poskytovatel natypovaný do šablony. Každá karta jeho pásu důvěry nese hodnotu ze svého vlastního datasetu — release, který instalátor vyhodnotí, a příkaz, který jej potvrdí z data/registry/distribution.json, commit, ze kterého byl tento build vytvořen, jak jej servíruje build.json, provedené případy užití z katalogu — a tam, kde dataset nic nenese, čte unknown, takže karta, za kterou nic nestojí, nemůže projít jako známá.
Fungující rozhraní, která uvádí, patří také datům: stabilní funkce, které webová topologie přisuzuje povrchu interface, v pořadí funkcí, poté ostatní povrchy produktového modelu. Rozhraní je odkazováno jako publikované přesně tehdy, když topologie přiřadí jeho mount povrchu, který publikace nese; to, na co odpovídá jen běžící proces, uvádí svůj mount a neodkazuje na žádnou kopii, takže stránka nemůže poslat návštěvníka na adresu, kterou nic neobsluhuje, ani dál nazývat publikovaný povrch lokálním.
Hero otevírá produkt a který produkt, na to odpovídají data: první z těch rozhraní. Hero nese právě jednu výzvu k jeho otevření, která pojmenovává jeho funkci; výzva vede na jeho mount, když ho tam drží publikace, a na žádnou takovou adresu, když na něj odpovídá jen běžící proces; pohled, který hero kreslí vedle výzvy, je pohledem na ten produkt, a úkoly, které počítá, jsou úkoly plánu, podle stavů plánu, v pořadí plánu.
To, co domovská stránka nutí stáhnout každého návštěvníka, je rovněž deklarováno, jako [budget] v site/data/homepage.toml: bajty vlastního HTML, bajty skriptů a stylů, které načítá z webu, a bajty dat grafu, která nese inline. Stránka nad kterýmkoli z těch tří, rozpočet, který jeden vynechá, nebo stránka odkazující na aktivum, které build nevytvořil, je odmítnuta. HTML nemělo rozpočet do 2026-10-12 a dosáhlo 243 477 bajtů. Žádná stránka webu nenačítá runtime Mermaid bez diagramu k vykreslení — domovská stránka ho načítala po celou dobu své existence a platila nejtěžším souborem webu za nic.
Sekce, jejichž detailní stránky jsou doklady, se deklarují jednou, jako [indexing] unlisted v site/data/nav.toml. Každá stránka pod takovou sekcí nese robots noindex a chybí v sitemap.xml; každá jiná stránka je indexovatelná a v něm je, pokud si její vlastní front matter nevyžádá noindex, a pak chybí i v sitemap. Stránky zůstávají publikované a odkazované: nezařazení se týká řazení ve vyhledávání, ne dostupnosti.
Chování při selhání
scripts/ci/homepage-check skončí kódem 10 s jedním zjištěním na porušení, které pojmenovává sekci, funkci, příkaz nebo stránku; scripts/site-check hlásí svá zjištění a selže s ním, takže build Pages odmítne publikovat domovskou stránku nebo mapu webu, které se od své deklarace odchýlily.
Ověření
test/cases/333_homepage_narrative.sh sestaví malý strom webu a dokazuje každou kontrolu oběma směry: čistý strom projde a stránka načítající Mermaid bez diagramu, HTML, skripty nebo vložený JSON nad deklarovaným rozpočtem, nedeklarovaný rozpočet, rozpočet bez HTML, chybějící odkazované aktivum, rozhraní, které stránka neuvádí nebo které data nedávají, odkazovaná publikovaná kopie, kterou topologie nenese, publikovaný povrch stále popsaný jako lokální, hero, které neotevírá žádný produkt, takové napsané do šablony, takové poslané na adresu, na kterou odpovídá jen proces, publikované, ke kterému hero nevede, pohled na něco jiného, údaj, který plán nedává, nedeklarovaná sekce, deklarovaná sekce nevykreslená, sekce ve špatném pořadí, prázdná sekce, odkazovaná konceptová funkce, chybějící instalační příkaz, provider modelu, který stránka nejmenuje, jméno, které model nenese, karta důvěry nesouhlasící se svou datovou sadou, zcela chybějící karta důvěry, stránka účtenky bez noindex, stránka účtenky v sitemap a indexovatelná stránka v ní chybějící — každé selže nálezem, který jmenuje, co je špatně.