Phase 0: Documentation Site
Stand up the documentation site at doc.redactedworld.com so that every subsequent phase has a living reference for design decisions, implementation progress, and operational runbooks.
Prerequisites
None -- this is the first phase.
Blocks
| ID | Block | Description | Acceptance Criteria |
|---|---|---|---|
| 0.1 | Scaffold Docusaurus project | Initialize a Docusaurus 3 project under docs-site/ with TypeScript config, the classic preset, and a custom dark-hacker theme that matches the RedactedWorld brand. | npx docusaurus build succeeds; local dev server renders the landing page with correct branding. |
| 0.2 | Design docs content | Write the design documentation pages covering architecture overview, services, data stores, infrastructure, authentication, theming, domain verification, pentesting tools, and job execution. | All pages listed in the sidebar under "Design" render without errors and contain substantive content (no placeholders). |
| 0.3 | Implementation plan pages | Create this set of plan pages -- an index plus one page per phase (0-8) -- with block tables, acceptance criteria, and dependency information. | All 10 plan pages render; the index table lists all 9 phases with correct block counts. |
| 0.4 | Progress tracker component | Build a React component that reads a JSON progress file and renders phase/block completion status with progress bars. Embed it on the plan index page. | Component renders on the plan index; updating the JSON file changes the displayed progress without a code change. |
| 0.5 | Dockerfile & K8s manifests | Write a multi-stage Dockerfile (node:20-alpine build, nginx:alpine serve) and Kubernetes manifests (Deployment, Service, IngressRoute) for doc.redactedworld.com. | docker build succeeds; kubectl apply creates the resources; the site is reachable at the target URL inside the cluster. |
| 0.6 | Deploy to doc.redactedworld.com | Deploy the documentation site image to the cluster behind Traefik and verify it is publicly accessible. | curl -s -o /dev/null -w "%{http_code}" https://doc.redactedworld.com returns 200. |
Estimated Scope
| Area | Files / Resources |
|---|---|
| Repository | docs-site/ directory (Docusaurus project root) |
| Docs content | docs-site/docs/design/*.md, docs-site/docs/plan/*.md |
| React components | docs-site/src/components/ProgressTracker/ |
| Container | docs-site/Dockerfile |
| Kubernetes | k8s/docs-site/deployment.yaml, k8s/docs-site/service.yaml, k8s/docs-site/ingressroute.yaml |