Summary
The process documentation in docs/roadmap.md, docs/maintainers.md, and docs/contributing/* was removed from the MkDocs navigation in #5426 but remained published and reachable. These orphaned pages have since become stale and diverged from the repository's current processes.
Why is this needed?
The pages present the 2025 roadmap as current, contain broken links and removed commands such as make dev and npm run test:parallel, and make inaccurate claims about coverage enforcement and PR title-check comments. They also duplicate guidance now maintained in CONTRIBUTING.md and CODING_STANDARDS.md.
The maintainer documentation additionally describes repository-level label and release automation that has moved to the organization level. Keeping both versions published makes it unclear which instructions are authoritative.
Which area does this relate to?
Solution
Retire the orphaned process pages and consolidate current maintainer and contributor guidance in the root MAINTAINERS.md and CONTRIBUTING.md. Correct stale commands, links, and process claims, and remove the obsolete stale-issues and post-release repository workflows and supporting script now superseded by organization-level automation.
Acknowledgment
Disclaimer: After creating an issue, please wait until it is triaged and confirmed by a maintainer before implementing it. This will reduce amount of rework and the chance that a pull request gets rejected.
Future readers
Please react with 👍 and your use case to help us understand customer demand.
Summary
The process documentation in
docs/roadmap.md,docs/maintainers.md, anddocs/contributing/*was removed from the MkDocs navigation in #5426 but remained published and reachable. These orphaned pages have since become stale and diverged from the repository's current processes.Why is this needed?
The pages present the 2025 roadmap as current, contain broken links and removed commands such as
make devandnpm run test:parallel, and make inaccurate claims about coverage enforcement and PR title-check comments. They also duplicate guidance now maintained inCONTRIBUTING.mdandCODING_STANDARDS.md.The maintainer documentation additionally describes repository-level label and release automation that has moved to the organization level. Keeping both versions published makes it unclear which instructions are authoritative.
Which area does this relate to?
Solution
Retire the orphaned process pages and consolidate current maintainer and contributor guidance in the root
MAINTAINERS.mdandCONTRIBUTING.md. Correct stale commands, links, and process claims, and remove the obsoletestale-issuesandpost-releaserepository workflows and supporting script now superseded by organization-level automation.Acknowledgment
Disclaimer: After creating an issue, please wait until it is triaged and confirmed by a maintainer before implementing it. This will reduce amount of rework and the chance that a pull request gets rejected.
Future readers
Please react with 👍 and your use case to help us understand customer demand.