Skip to content

feat(assets): backport handbook with per-release versioned docs#47

Merged
nerdalytics merged 44 commits into
trunkfrom
feat/handbook-backport
Apr 3, 2026
Merged

feat(assets): backport handbook with per-release versioned docs#47
nerdalytics merged 44 commits into
trunkfrom
feat/handbook-backport

Conversation

@nerdalytics
Copy link
Copy Markdown
Owner

Summary

  • Backports handbook infrastructure (SvelteKit, components, styles, fonts) from epoch-2
  • Adds per-release versioned documentation for all 11 published releases (v1.0.0 through v1000.3.0)
  • Each version has its own route directory with immutable content matching the API at that release
  • Version selector with fallback to landing page when target version lacks the current page
  • Version-specific badges (Socket.dev, static version badge) on each landing page
  • Migration guides for every version transition
  • Fixes root package.json exports ordering to prevent Vite warnings

Versions documented

Epoch Versions
0 v1.0.0
1 v1000.0.0, v1000.1.0, v1000.1.1, v1000.2.0, v1000.2.1, v1000.2.2, v1000.2.3, v1000.2.4, v1000.2.5, v1000.3.0

Test plan

  • cd handbook && npm ci && npm run build succeeds
  • All version landing pages render at /v{version}
  • Version selector dropdown switches between versions
  • Switching to a version that lacks the current page falls back to landing
  • Beacon logo navigates to the active version's landing
  • Scroll resets on page navigation
  • Content pages match the API surface at each git tag
  • Migration guides document every breaking change
  • Badges render correctly per version

Extract SvelteKit scaffold, components, styles, fonts, and build
config. Skip v2000 content routes, navigation.ts, and versions.ts
which will be rewritten for v1.0.0. Update .gitignore whitelist
to allow handbook files and exclude .svelte-kit build artifacts.
…quick-start, state, effects, derived, batch, architecture, links
…n, quick-start, state, effects, derive, batch, select, architecture, links
@socket-security
Copy link
Copy Markdown

socket-security Bot commented Apr 3, 2026

@nerdalytics nerdalytics merged commit 3667f72 into trunk Apr 3, 2026
12 checks passed
@nerdalytics nerdalytics deleted the feat/handbook-backport branch April 3, 2026 21:25
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant