Skip to content

Comments

organize docs roadmap merge complete issues #60

Open
jlucus wants to merge 5 commits intoclaude/complete-issue-21-tasks-SlVUQfrom
claude/organize-docs-roadmap-9Bw5a
Open

organize docs roadmap merge complete issues #60
jlucus wants to merge 5 commits intoclaude/complete-issue-21-tasks-SlVUQfrom
claude/organize-docs-roadmap-9Bw5a

Conversation

@jlucus
Copy link
Collaborator

@jlucus jlucus commented Feb 11, 2026

Update soon

Implements the DOCS_STRUCTURE_PROPOSAL.md reorganization:
- Move 15 documentation files from root into docs/ subdirectories
  (governance/, planning/, operations/, business/, audit/, automation/)
- Move scripts and labels.json into scripts/ directory
- Create README.md index files for docs hub and each subdirectory
- Create docs.json central documentation index with classification,
  ownership, and update cadence metadata per DOCUMENT_CLASSIFICATION_POLICY
- Update all internal cross-references across 31+ files including
  workflows, issue templates, and moved documents
- Update root README.md with documentation navigation section

Root now contains only standard GitHub files (README, CONTRIBUTING,
SECURITY, LICENSE, PR template) keeping it clean and navigable.

https://claude.ai/code/session_014pmU63keycr2m1B1LnU2RZ
Fix template paths to match new docs/ directory layout and bump
Last Updated date, satisfying DOCUMENT_CLASSIFICATION_POLICY Section 2.1
requirement that issue template changes include PROJECT_BOARD_GUIDE updates.

https://claude.ai/code/session_014pmU63keycr2m1B1LnU2RZ
…structure

Resolves merge conflict between docs reorganization and Issue #21
(complete-issue-21-tasks) branch:

Conflict: Issue #21 added Project #10 setup documentation to
PROJECT_BOARD_GUIDE.md at root, while our branch moved that file
to docs/operations/. Resolution keeps all Issue #21 content
(164 lines of column config, automation rules, testing workflow)
in the new docs/operations/ location with corrected relative links.

Additional changes:
- Move PROJECT_BOARD_VERIFICATION.md into docs/operations/
- Fix internal links in verification doc for new directory context
- Add verification doc to docs.json index and operations README

https://claude.ai/code/session_014pmU63keycr2m1B1LnU2RZ
Update hardcoded root-level file paths in both workflows to match
the new docs/ directory structure. This was causing false positives
on the freshness check (couldn't find PROJECT_BOARD_GUIDE.md at root
since it moved to docs/operations/) and would cause the staleness
audit to silently skip all moved documents.

Changes:
- doc-freshness-check.yml: Update livingDocs array and use
  .some(f => f.endsWith()) for flexible path matching on PR diffs
- doc-staleness-audit.yml: Update docs array with full paths

https://claude.ai/code/session_014pmU63keycr2m1B1LnU2RZ
Update the API path to fetch docs/planning/GOALS.md with fallback
to the legacy root path for transition compatibility. Without this,
the workflow would fail to load goal definitions after the docs
reorganization merges to master.

Goal 3: Establish Governance & Processes - this PR implements the
approved docs structure proposal and document classification policy.

https://claude.ai/code/session_014pmU63keycr2m1B1LnU2RZ
@github-actions github-actions bot added bug Something isn't working size: XS Extra small - less than 1 day type: documentation Documentation changes type: governance Governance and organizational changes type: infrastructure CI/CD and workflow infrastructure changes labels Feb 11, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

bug Something isn't working size: XS Extra small - less than 1 day type: documentation Documentation changes type: governance Governance and organizational changes type: infrastructure CI/CD and workflow infrastructure changes

Projects

None yet

3 participants