Skip to content

chore: archive planning docs under admin/planning and remove root cruft - #242

Merged
accesswatch merged 1 commit into
mainfrom
chore/planning-archive-cleanup
Jul 4, 2026
Merged

accesswatch merged 1 commit into
mainfrom
chore/planning-archive-cleanup

Conversation

@accesswatch

Copy link
Copy Markdown
Collaborator

Root directory professionalization:

  • Move completed and in-flight planning documents out of the root into
    admin/planning/: DEPLOYMENT_ASSESSMENT.md, REVIEW-2026-07-02.md,
    REORG-PLAN.md, SHIP-CHECKLIST.md, plus docs/SITE-IA.md and
    docs/TOOLING-INVENTORY.md (planning inputs, not curriculum). Relative
    links between them rewritten for the new location.
  • Add admin/planning/README.md: consolidated initiative index with status
    (shipped vs in flight), shipped-initiative summaries, and the rule that
    new planning docs belong there, not the root.
  • Delete true junk: datetime (empty stray file), 'GitHub Learning
    Room.docx' (February draft superseded by docs/), COMING_SOON.md
    (pre-launch teaser), github/index.html (redirect stub never deployed;
    Pages serves only the html/ artifact).
  • Remove the stale html/ outputs for moved and deleted pages; html/
    regenerated (396 files).

No references to the moved or deleted files exist outside the archive
itself. golden.md (project north star) and work.md (generated) untouched.

Co-Authored-By: Claude Fable 5 noreply@anthropic.com

Root directory professionalization:

- Move completed and in-flight planning documents out of the root into
  admin/planning/: DEPLOYMENT_ASSESSMENT.md, REVIEW-2026-07-02.md,
  REORG-PLAN.md, SHIP-CHECKLIST.md, plus docs/SITE-IA.md and
  docs/TOOLING-INVENTORY.md (planning inputs, not curriculum). Relative
  links between them rewritten for the new location.
- Add admin/planning/README.md: consolidated initiative index with status
  (shipped vs in flight), shipped-initiative summaries, and the rule that
  new planning docs belong there, not the root.
- Delete true junk: datetime (empty stray file), 'GitHub Learning
  Room.docx' (February draft superseded by docs/), COMING_SOON.md
  (pre-launch teaser), github/index.html (redirect stub never deployed;
  Pages serves only the html/ artifact).
- Remove the stale html/ outputs for moved and deleted pages; html/
  regenerated (396 files).

No references to the moved or deleted files exist outside the archive
itself. golden.md (project north star) and work.md (generated) untouched.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Copilot AI review requested due to automatic review settings July 4, 2026 17:27
@accesswatch
accesswatch requested a review from taylorarndt as a code owner July 4, 2026 17:27
@accesswatch
accesswatch merged commit 0913029 into main Jul 4, 2026
5 checks passed
@accesswatch
accesswatch deleted the chore/planning-archive-cleanup branch July 4, 2026 17:27
@github-actions

github-actions Bot commented Jul 4, 2026

Copy link
Copy Markdown
Contributor

Peer Review Assigned

Hi @accesswatch! Your PR has been automatically paired with @taylorarndt for peer review.

For @taylorarndt:

This is a great opportunity to practice code review skills! Here's what to look for:

Content Quality:

  • Does the change accomplish what the issue describes?
  • Is the writing clear and helpful?
  • Are there any typos or grammar issues?

Accessibility:

  • Proper heading hierarchy (H1 → H2 → H3, no skips)?
  • Descriptive link text (not "click here")?
  • Alt text on images?
  • [TODO] markers removed?

Documentation:

  • Code blocks are properly formatted?
  • Tables have headers?
  • References/links work correctly?

Review Guidelines:

  • Be kind and constructive
  • Suggest improvements, don't just point out problems
  • Ask questions if something is unclear
  • Approve when ready or request changes with explanation

Resources:


Pairing by Learning Room Grouping Engine

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR “professionalizes” the repository root by moving planning/initiative documents into admin/planning/, removing obsolete root artifacts, and updating the committed html/ build outputs (including the site search index) to match the new structure.

Changes:

  • Archived planning docs under admin/planning/ (and added an index/README for the archive).
  • Removed obsolete root content (e.g., COMING_SOON.md, github/index.html) and regenerated html/ outputs accordingly.
  • Updated html/search-index.json and planning HTML pages to reflect new URLs/paths.

Reviewed changes

Copilot reviewed 16 out of 21 changed files in this pull request and generated no comments.

Show a summary per file
File Description
html/search-index.json Updates search index entries to remove deleted/moved pages and add admin/planning/* pages.
html/COMING_SOON.html Removes generated HTML for deleted “Coming Soon” page.
html/admin/planning/TOOLING-INVENTORY.html Updates generated planning page paths/links for new location.
html/admin/planning/SITE-IA.html Updates generated planning page paths/links for new location.
html/admin/planning/SHIP-CHECKLIST.html Updates generated planning page paths/links for new location.
html/admin/planning/REVIEW-2026-07-02.html Updates generated planning page paths/links for new location.
html/admin/planning/REORG-PLAN.html Updates generated planning page paths/links for new location.
html/admin/planning/DEPLOYMENT_ASSESSMENT.html Updates generated planning page paths/links for new location.
html/admin/planning/README.html Adds generated HTML for the planning archive README/index content.
html/admin/planning/index.html Adds generated HTML index page for admin/planning/.
github/index.html Removes unused redirect stub file.
datetime Removes stray root file.
COMING_SOON.md Deletes obsolete root “Coming Soon” markdown page.
admin/planning/TOOLING-INVENTORY.md Fixes some relative links after moving planning docs under admin/planning/.
admin/planning/SITE-IA.md Fixes some relative links after moving planning docs under admin/planning/.
admin/planning/SHIP-CHECKLIST.md Updates cross-links to refer to new planning doc locations.
admin/planning/REVIEW-2026-07-02.md Adds the July 2 ops review document under the planning archive.
admin/planning/REORG-PLAN.md Updates authoritative-source links to point at docs/ from the new location.
admin/planning/README.md Adds a consolidated planning archive index and status overview.
admin/planning/DEPLOYMENT_ASSESSMENT.md Adds the deployment assessment document under the planning archive.
Comments suppressed due to low confidence (3)

admin/planning/SITE-IA.md:275

  • The “Episode map schema” link is broken after moving this document under admin/planning/; the schema file lives in docs/EPISODE-MAP-SCHEMA.json, so this relative link should point to ../../docs/EPISODE-MAP-SCHEMA.json.
    admin/planning/TOOLING-INVENTORY.md:162
  • The “Episode map schema” link is currently relative to admin/planning/, but the schema lives in docs/EPISODE-MAP-SCHEMA.json. Update this to ../../docs/EPISODE-MAP-SCHEMA.json so the link works in-repo.
    admin/planning/TOOLING-INVENTORY.md:170
  • This section-level source map still links to EPISODE-MAP-SCHEMA.json as if it were in admin/planning/. The schema file is in docs/, so this should also use ../../docs/EPISODE-MAP-SCHEMA.json.

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.

2 participants