chore(docs): consolidate markdown under docs/ + distill audits into changelog (PSA-48) #305

Merged
vas2000-work merged 1 commit from chore/PSA-48-docs-sanitize into main 2026-07-01 06:27:56 +02:00
Owner

Phase 1 (docs reorg) of PSA-48 for bunyip. Reversible content change; the irreversible history rewrite is a separate follow-up.

What changed

  • Every markdown file except root README.md and CLAUDE.md now lives under docs/ (public / how-to) or docs/dev-docs/ (internal working notes). README files stay colocated with their code; non-md files and directories are untouched.
  • Repointed every path reference: .env.example, CLAUDE.md, compose.dev.yml, compose.yml, the justfile, a source comment, and the subscriptions admin string in dashboard.rs.
  • Removed the 2026-06-06 platform-audit tree and the 2026-05-15 milestone-1 handoff, distilled name-free into docs/dev-docs/CHANGELOG.md (audit = substantial entry, milestone = moderate, reorg = short).
  • Excluded docs/ from the Docker build context.

Not in this PR

  • The git-history rewrite (purging the removed docs + the local-only For AI/ dir from history, stripping contributor names from commit messages, keeping author fields) is the separate Phase 2 that needs branch protection lifted.

Verification

just check-container green: fmt, clippy -D warnings, workspace tests pass. No dangling doc links remain.

#PSA-48

Phase 1 (docs reorg) of PSA-48 for bunyip. Reversible content change; the irreversible history rewrite is a separate follow-up. ## What changed - Every markdown file except root `README.md` and `CLAUDE.md` now lives under `docs/` (public / how-to) or `docs/dev-docs/` (internal working notes). README files stay colocated with their code; non-md files and directories are untouched. - Repointed every path reference: `.env.example`, `CLAUDE.md`, `compose.dev.yml`, `compose.yml`, the `justfile`, a source comment, and the subscriptions admin string in `dashboard.rs`. - Removed the 2026-06-06 platform-audit tree and the 2026-05-15 milestone-1 handoff, distilled name-free into `docs/dev-docs/CHANGELOG.md` (audit = substantial entry, milestone = moderate, reorg = short). - Excluded `docs/` from the Docker build context. ## Not in this PR - The git-history rewrite (purging the removed docs + the local-only `For AI/` dir from history, stripping contributor names from commit messages, keeping author fields) is the separate Phase 2 that needs branch protection lifted. ## Verification `just check-container` green: fmt, clippy `-D warnings`, workspace tests pass. No dangling doc links remain. #PSA-48
chore(docs): consolidate markdown under docs/, distill audits + handoff into changelog
All checks were successful
E2E / Playwright against deployment (pull_request) Successful in 24s
Check / fmt + clippy + build + tests (pull_request) Successful in 10m1s
Create release / Create release from merged PR (pull_request) Has been skipped
12a9efa038
Move every non-README/CLAUDE markdown file into docs/ (public how-to) and docs/dev-docs/ (internal working notes). README and CLAUDE stay at the root, README files stay colocated with their code. Path references in .env.example, CLAUDE.md, compose files, the justfile, a source comment, and the subscriptions admin string were repointed to the new locations.

Remove the 2026-06-06 platform-audit tree and the 2026-05-15 milestone-1 handoff from the tree and distill both, name-free, into docs/dev-docs/CHANGELOG.md at varying depth. Exclude docs/ from the Docker build context.

This is the reorg phase; a follow-up history rewrite purges the removed docs and the local-only For AI/ scratch dir from git history and strips contributor names from commit messages.

#PSA-48

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
vas2000-work scheduled this pull request to auto merge when all checks succeed 2026-07-01 06:19:26 +02:00
vas2000-work deleted branch chore/PSA-48-docs-sanitize 2026-07-01 06:27:57 +02:00
Sign in to join this conversation.
No reviewers
No labels
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
psa-systems/bunyip!305
No description provided.