5 Commits

Include renames

Author	SHA1	Message	Date
John O'Keefe	649f821850	docs nav: correct casing of 'Searching and Filtering' sidebar label ... docTitleOverrides now pins the label with lowercase 'and' (the naive titleCase fallback capitalized every word); only the sidebar label was affected — the page h1 comes from the markdown heading and was already correct. Test pin added to TestDocTitle.	2026-10-26 08:26:53 -04:00
John O'Keefe	56dbca37d0	docs nav: move Administration above Devices in sidebar order	2026-10-25 21:15:47 -04:00
John O'Keefe	27f42bf703	docs nav: promote Devices and Administration out of User Guide ... Follows the developer/api → API Reference carve-out: placement-only, no file paths or URLs change. placeDoc routes user/devices/* to a new top-level "Devices" section (icon: device) and user/admin-* to a new top-level "Administration" section (icon: shield); User Guide keeps its direct guides with no groups. Sidebar order: Getting Started, User Guide, Devices, Administration, API Reference, Developer, Operations, Contributing. Verified live: on kobo-setup the Devices section opens with the three device guides; on admin-guide Administration opens with both admin guides; on user/dashboard User Guide opens as before. Tests (TestPlaceDoc, TestBuildNavigation) updated to pin the new placement.	2026-10-25 21:10:53 -04:00
John O'Keefe	73e8cdef4b	docs(ui): drop sidebar saved-state — server defaults already ARE the standard docs behavior ... Simplification per spec: the menu tracks state through the URL alone. Land on /docs: fully closed, headers only (an explicit home rule now overrides the contains-URL rule, since the root overview doc lives in Getting Started and would otherwise auto-open it). Land on any doc page: its containing section + group render open at first paint, current link bold — no JS, no jump, arrows consistent. Navigate elsewhere: old closes, new opens. Deleted: docs_nav cookie const/parse, ApplyNavOverrides, cookie write + collect/persist helpers in web/src/docs.ts, data-key attributes in the sidebar templ, and the first-section-open fallback (docs home used to force-open the first section — spec'd as closed). toggleCollapsible remains for in-page peeking; purely ephemeral. The [data-collapsed=true] CSS from the previous round stays — it is what makes the server-rendered state actually hide sections at paint (the original bug was that this CSS never existed). Tests: TestBuildNavigationNothingCurrent now asserts zero sections open on unmatched paths; TestBuildNavigation asserts Getting Started closed on a device page (no site-wide pin). make test green; 146 vitests; live verified: home 0 expanded, doc pages exactly 2 (section+group).	2026-10-24 21:17:55 -04:00
John O'Keefe	84cd6328f4	feat(docs): standalone docs site chrome + category/subcategory navigation ... Docs pages no longer embed the app Header (whose hx-post login form silently degraded to a native GET, leaking credentials into the URL — this page never loaded htmx). New docs-owned topbar: search, theme picker, Open App; anonymous visitors get a plain /login link. Optional-auth middleware (hand-rolled — echojwt's ErrorHandler return ends the chain, producing empty 200s) populates the user for signed-in visitors. Navigation rebuilt from the docs directory tree: 6 sections, subcategory groups, server-rendered expansion and active states. Search results are a templ partial (/docs/search/partial); code highlighting is server-side chroma (previously dead hljs CSS); prose is theme-aware via typography DEFAULT vars (prose-invert painted unreadable text under light themes). /docs renders the index directly; standalone 404 without the tailwind CDN. Tests: navigation routing/expansion (internal/docs), render pins asserting no login form/password field/app sidebar ever return on docs pages. lint-rendering: exempt *.test.ts fixtures (jsdom DOM building); docs.ts baseline 5 -> 1.	2026-10-24 14:31:36 -04:00