Skip to content

docs: consolidate and prune stale documentation - #54

Closed
mariuspruvot wants to merge 1 commit into
mainfrom
docs/consolidate-and-prune
Closed

docs: consolidate and prune stale documentation#54
mariuspruvot wants to merge 1 commit into
mainfrom
docs/consolidate-and-prune

Conversation

@mariuspruvot

Copy link
Copy Markdown
Owner

Summary

  • Test PR for helprs — consolidates and prunes stale documentation.

Test plan

  • Trigger helprs session on this PR

Remove docs that describe removed code or abandoned deployment targets,
consolidate the four architecture docs into a single architecture.md,
regenerate the frontend component inventory from the current tree, and
bring API contracts + data models back in sync with the code.

- Drop 8 stale docs (AWS ECS guide, architecture-api/web/infra
  projections, source-tree-analysis, integration-architecture,
  project-overview, old component-inventory-web).
- Rewrite docs/architecture.md as the single human-facing source of
  truth (CLAUDE.md stays the agent-facing one).
- Regenerate component-inventory-web.md from apps/web/src/ (adds the
  dashboard feature, removes dangling landing/ references).
- Rewrite api-contracts-api.md with all current routes, including
  /auth/me/stats, installation session listing, post-results toggle,
  and the full /containers/sessions/* surface.
- Update data-models-api.md: add Installation.post_results_to_pr,
  the session_events table, the ContainerSession scorecard/xp_earned
  columns, and the missing Pydantic schemas.
- Align .env.example with what the compose files actually need
  (VITE_GITHUB_APP_SLUG, DOCKER_GID, POSTGRES_PASSWORD).
- Clean up development-guide.md, deployment-guide.md, self-hosting.md,
  CONTRIBUTING.md, and docs/index.md (drop FRONTEND_URL, AWS ECS
  references, "Coming in Phase 2" placeholders; add the new docs/backlog.md
  to the index).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@helprs-prod

helprs-prod Bot commented Apr 24, 2026

Copy link
Copy Markdown

helPRs session created for this PR.

Skill: challenge-me | Open session

@mariuspruvot

Copy link
Copy Markdown
Owner Author

Closing — superseded by #52 (same change, already merged into main).

@mariuspruvot
mariuspruvot deleted the docs/consolidate-and-prune branch May 28, 2026 19:21
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