Parent epic: #768 — Documentation epic
Base branch: theme-elementary-v2. Cover its functionality and subsequent changes based on it. Verify against the latest relevant v2 implementation and record the tested commit in the documentation PR.
Problem and scope
Pilot workarounds and dependency-development procedures obscure normal setup and can become stale. Create a small docs/internal/ area and migrate relevant material from docs/internal-testing.md.
Proposed structure
Start with two documents; split further only when the content warrants it:
docs/internal/README.md: audience, supported revisions, index, and status of temporary procedures.
docs/internal/maintenance.md: release validation and local dependency development.
Link to existing knowledge-graph guidance. Move or split graph maintenance details only where necessary; keep instructions needed by downstream developers discoverable.
Maintenance guide contents
- Release validation: test the advertised installation paths, initialization, representative example removal/feature toggles, local startup, builds, and checks.
- Cleanup validation: verify actual retained files and documentation links; report broken scripts or removed capabilities as implementation issues.
- Local dependency development: sibling wp-framework/wp-tooling setup, local source overrides, and restoring only those overrides while retaining theme identity changes.
- Temporary pilot procedures: why each is needed, applicable revision/date, and an explicit retirement condition.
- Documentation validation: record journey and link-check results; link CI automation work separately if required.
Acceptance criteria
Parent epic: #768 — Documentation epic
Base branch:
theme-elementary-v2. Cover its functionality and subsequent changes based on it. Verify against the latest relevant v2 implementation and record the tested commit in the documentation PR.Problem and scope
Pilot workarounds and dependency-development procedures obscure normal setup and can become stale. Create a small
docs/internal/area and migrate relevant material fromdocs/internal-testing.md.Proposed structure
Start with two documents; split further only when the content warrants it:
docs/internal/README.md: audience, supported revisions, index, and status of temporary procedures.docs/internal/maintenance.md: release validation and local dependency development.Link to existing knowledge-graph guidance. Move or split graph maintenance details only where necessary; keep instructions needed by downstream developers discoverable.
Maintenance guide contents
Acceptance criteria