feat(handbook): navigable, searchable handbook with callouts, FAQ and figure lightbox - #59
Merged
Merged
Conversation
… figure lightbox
Turns the handbook from one long scroll into proper product documentation:
- Sticky sidebar table of contents with scroll-spy — the current chapter is
highlighted as you read. Collapses to a chip row on narrow screens.
- Live search that filters chapters (title + body) as you type; "/" focuses it,
Esc clears, with a no-results note.
- Shareable deep links (/handbook?s=requesting scrolls straight there) and a
hover "copy link" affordance on every chapter heading.
- Callout boxes (tip / note / privacy / warning) lift the key points out of the
prose — a 30-second "quick start", the confidentiality guarantees, the
overlap/past-date rules, and the "verify the working-day count" warning.
- An FAQ chapter answering the real questions ("how many days do I have left?",
"can I cancel approved leave?", "who sees my sick leave?"), with HR-only
entries added on the HR route.
- Click any figure to open it in a full-screen lightbox (the dense dashboards
and the animated walkthroughs are finally readable at full size).
- Subtle scroll-reveal as chapters enter, and a Print button + print stylesheet
for a clean handout. All reduced-motion-aware.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Turns the handbook from one long scroll into something that reads like real product documentation. All four improvements from the wishlist:
Navigation
…/handbook?s=requestingscrolls straight to that chapter on load, and every heading gets a hover 🔗 copy-link.Search
/focuses the box, Esc clears, with a "nothing matches" note.Scannability
Polish
prefers-reduced-motion-aware.New reusable
Callout.vue; the handbook prose and figures are unchanged in wording. Verified on the dev instance: sidebar/scroll-spy, search (carry-over→ the 4 chapters that mention it), deep links, copy-anchors, lightbox, and print all work. eslint 0 errors, stylelint clean, build ✓.🤖 Generated with Claude Code