mirror of
https://github.com/hanzo-docs/docs.git
synced 2026-10-25 04:20:02 +00:00
zeekay
f3910bbe58
docs.hanzo.ai documented three key types. Cloud mints two. cloud.APIKeyPrefixes is pk- and sk-; hk- and hz- have never existed and an unrecognized spelling is refused at the door, so a reader's first call failed asking for a credential nobody can issue. 149 files carried one. sk- was the subtler half: present, and described as an org-level provider credential when it resolves to the USER. A find-and-replace would have left that confidently wrong, so the pages that made a further claim -- a scope, a third family, a list of recognized prefixes -- were rewritten rather than swapped. Derived, not restated. openapi-doc gains Document.keys, read out of the /v1/keys prose the Go handler writes and zipdoc lifts into the document. gen-key-types renders that as an MDX fragment api-keys.mdx includes, so the table nobody may type is not typed. secretKey(doc) replaces the literal three generators each kept -- which is how three GENERATED pages also came to teach hk-. check-keys then holds every page to it, both directions: a prefix the document does not carry fails the build, and a class api-keys.mdx does not teach fails it too. Renaming pk- in cloud now stops the build in six places instead of publishing a stale page. Also measured against the live API and cluster, and corrected: /v1/keys does mint keys over HTTP (403 unauthenticated, not absent); Tasks is /v1/tasks on the one host, not gRPC elsewhere; the KMS example path 404s; and four KMSSecret manifests could not apply -- two named groups with no controller, and their spec was External Secrets' shape, not the CRD's five fields. Sidebar sits flush left. The docs grid was five columns centring a band, with the sidebar area spanning the leading gutter, so the nav began 176.5px in at 1920 and 496.5px in at 2560 -- inside its own bordered card. Three columns now: rails pinned, page between them. Measured at /docs/api-keys before -> after: 1920 176.5/232/1052/268/176.5 -> 232/1405/268, 2560 496.5/232/1052/268/496.5 -> 232/2045/268, nav at x=0. Phone 390 and tablet 820 unchanged (0/375/0 and 232/573/0, drawer opens, no page overflow); desktop collapse and restore verified.