Files
SubMiner/backlog/completed/task-155 - Move-user-docs-site-back-into-main-repo.md
sudacode 48f10dbb03 chore(backlog): maintain task backlog and add changelog fragments
- Move completed tasks (85, 117, 118, 155) to backlog/completed/
- Delete superseded task files (166 verification, 172 drilldown)
- Add stats dashboard milestone m-1
- Add new tasks (190, 194)
- Update task metadata across remaining backlog items
- Add changelog fragments for stats, mpv args, and subtitle filtering
2026-03-18 02:25:07 -07:00

2.1 KiB

id, title, status, assignee, created_date, updated_date, labels, dependencies, priority, ordinal
id title status assignee created_date updated_date labels dependencies priority ordinal
TASK-155 Move user docs site back into main repo Done
2026-03-10 19:20 2026-03-10 19:38
medium 15500

Description

Move the standalone VitePress docs site from the sibling ../subminer-docs checkout back into the main SubMiner repo so docs can be updated alongside code and local tooling can reference one repository.

Scope:

  • import the tracked docs-site source into a dedicated in-repo subdirectory
  • update scripts/tests/docs instructions that assume a sibling ../subminer-docs checkout
  • preserve Cloudflare Pages deployability from a repo subdirectory
  • verify the app repo and docs site both still build/test from the new layout

Acceptance Criteria

  • #1 The user-facing VitePress docs source lives inside the SubMiner repo in a dedicated subdirectory.
  • #2 First-party scripts/tests/docs no longer require ../subminer-docs for normal operation.
  • #3 In-repo docs instructions include the Cloudflare Pages subdirectory deploy settings.
  • #4 Verification covers the relocated docs site build/tests plus affected app-repo checks.

Final Summary

Imported the VitePress site into docs-site/ inside the main repo and updated project instructions, docs contributor guidance, generator logic, and regression tests to treat that in-repo directory as the docs source of truth.

Added root proxy scripts for docs:dev, docs:build, docs:preview, and docs:test, repointed config-example generation to docs-site/public/config.example.jsonc, switched docs edit links to the main SubMiner repo, and documented the Cloudflare Pages subdirectory settings (docs-site root, .vitepress/dist output, docs-site/** watch path).

Verified with bun run format:check:src, bun run typecheck, bun run docs:test, bun run docs:build, bun run test:config:src, and bun run test:fast.