30 lines
1.7 KiB
Markdown
30 lines
1.7 KiB
Markdown
# 2026-02-23 Session Notes
|
|
|
|
## Astro Docs Migration — Task Assignment
|
|
|
|
Docs-worker joined the astro-migration team and received task #2: setting up Astro Content Collections for the documentation system. The task builds on completed Task #1 (Base layout, Nav, Footer, global.css).
|
|
|
|
## Task Scope
|
|
|
|
The docs-worker is responsible for creating six Astro components and config files:
|
|
1. **content.config.ts** — Glob-based content collection loader pointing at `../../docs`, excluding `docs/wip/`
|
|
2. **docs.css** — Sidebar, prose, code block, and responsive layout styles using Signet CSS variables
|
|
3. **Docs.astro layout** — Sidebar + content grid with Base layout inheritance
|
|
4. **Sidebar.astro component** — Navigation sidebar that groups docs by section and sorts by order field
|
|
5. **docs/index.astro** — 301 redirect to /docs/quickstart
|
|
6. **docs/[...slug].astro** — Dynamic route rendering individual docs
|
|
|
|
## Documentation Structure
|
|
|
|
26 total docs across 4 sections ordered for display:
|
|
- Getting Started (2): Quickstart, Configuration
|
|
- Core Concepts (6): Memory System, Pipeline, Skills, Memory Skills, Secrets, Hooks
|
|
- Reference (7): CLI, API, SDK, Daemon, Auth, Connectors, Harnesses
|
|
- Infrastructure (5): Architecture, Dashboard, Diagnostics, Analytics, Documents
|
|
- Project (5): Self-Hosting, Vision, README, Contributing, Roadmap, Agents
|
|
|
|
Frontmatter has already been added to all doc files (per task constraints).
|
|
|
|
## Key Design Notes
|
|
|
|
Sidebar must group sections in fixed order: Getting Started → Core Concepts → Reference → Infrastructure → Project. Within each section, docs are sorted by `order` frontmatter field. Current page is highlighted. All styling uses Signet's existing CSS variable system (colors, fonts, spacing). |