Kvalita veřejného API

Čemu musí vyhovovat veřejný povrch tohoto spustitelného souboru, měřeno z jeho syntaktického stromu: dokumentace, která říká víc než signatura, spustitelný příklad u všeho, co nese chování, hranice modulu, kterou něco procvičuje, a každý příkaz příkazové řádky zúčtovaný proti registru schopností. Pravidla jsou project.rust-public-api-quality a project.operation-transport-parity; toto je jejich měření.

• module quality
• builtin
• behaviorally_verified
• 2 schopnosti

Schopnosti

Každý je složen v souboru tohoto modulu; každý má vlastní stránku.

• quality.reportExportovaný povrch crate změřený proti pravidlům repozitáře: kolik položek je zdokumentovaných a má příklad, kolik modulů je zdokumentovaných, má příklad a je behaviorálně testováno, jak kanonické operace stojí vůči příkazové řádce, HTTP, OpenAPI a MCP, a jedno zjištění na porušení nesoucí stabilní kód, pravidlo, které ho vyžaduje, jeho soubor a řádek, proč na něm záleží a co s tím dělat.query · behaviorally_verified · majordomus_quality · GET /api/v1/quality
• quality.rustdocStrom rustdoc crate — artefakt povrchu rustdoc, jak ho řeší webová topologie — posouzený proti vlastnímu soupisu exportovaných položek crate: každá položka, která vlastní stránku, ji má na trase, kterou jí rustdoc přidělí, žádná stránka položky nezůstane bez položky, strom deklaruje, že byl sestaven z HEAD, index knihovny je přítomen a pojmenovává crate, jeho prostředky jsou přítomny, každý relativní odkaz se rozřeší a žádný soubor nepojmenovává stroj, na kterém vznikl, ani neobsahuje přihlašovací údaje. Vrací verdikt (clean, findings, nebo no_tree, když není co posuzovat), počty, které spojil, každý exportovaný modul s jeho stránkou a jedno typované zjištění na každou vadu se souborem a nápravou.query · behaviorally_verified · majordomus_quality_rustdoc · GET /api/v1/quality/rustdoc