docs: refresh roadmap for September planning - #6897
Conversation
Publish a theme-led Now/Next/Later snapshot from the September session and keep the August edition in docs/archived-roadmaps/ so monthly archives do not accumulate in one file. Assisted-by: Cursor Grok 4.6 Signed-off-by: Adam Scerra <ascerra@redhat.com> Co-authored-by: Cursor <cursoragent@cursor.com>
PR Summary by QodoRefresh September roadmap and add monthly archives
AI Description
Diagram
High-Level Assessment
Files changed (7)
|
Code Review by Qodo
1.
|
|
🤖 Review · Commit: |
Site previewPreview: https://09fe0eea-site.fullsend-ai.workers.dev Commit: |
Codecov Report✅ All modified and coverable lines are covered by tests. 📢 Thoughts on this report? Let us know! |
Gate auto-merge opt-in on revert/defect visibility, point maintainer process at the canonical GitHub file, and avoid nested H1/H2 inside the August archive snapshot. Assisted-by: Cursor Grok 4.6 Signed-off-by: Adam Scerra <ascerra@redhat.com> Co-authored-by: Cursor <cursoragent@cursor.com>
|
🤖 Finished Review · ✅ Success · Started 2:38 AM UTC · Completed 2:54 AM UTC Commit: Runtime: claude · Model: opus → claude-opus-4-6 · Effort: high · Cost: $5.46 |
|
Risk Assessment: moderate (2/5) DetailsTier 1 signals are unchanged from the prior assessment (large BLAST radius, CI_WORKFLOW_CHANGED, one protected path all reflecting benign documentation reorganization with zero security-sensitive or dependency changes); Tier 2 confirms low-risk documentation file history with no regression or contention signals; no linked issue; anchoring preserves prior score of 2. Previous runRisk Assessment: moderate (2/5) DetailsDocs-focused roadmap refresh with bulk archive moves inflating line count and BLAST radius, but all high-scoring signals (large BLAST, CI_WORKFLOW_CHANGED, protected path) reflect benign documentation reorganization with no functional code changes; prior score of 2 is preserved as Tier 1 signals are unchanged. Previous run (2)Risk Assessment: moderate (2/5) DetailsDocs-focused roadmap refresh with trivial 1-line touches to Makefile and pre-commit config; elevated slightly by CI workflow flag and protected path hit, but all non-doc changes are minimal config adjustments with no functional impact. Previous run (3)Risk Assessment: moderate (2/5) DetailsDocs-focused roadmap refresh with trivial 1-line touches to Makefile and pre-commit config; elevated slightly by CI workflow flag and protected path hit, but all non-doc changes are minimal config adjustments with no functional impact. Previous run (4)Risk Assessment: moderate (2/5) DetailsDocs-focused roadmap refresh with trivial 1-line touches to Makefile and pre-commit config; elevated slightly by CI workflow flag and protected path hit, but all non-doc changes are minimal config adjustments with no functional impact. Previous run (5)Risk Assessment: moderate (2/5) DetailsDocs-focused roadmap refresh with trivial 1-line touches to Makefile and pre-commit config; elevated slightly by CI workflow flag and protected path hit, but all non-doc changes are minimal config adjustments with no functional impact. |
ReviewFindingsHigh
Low
Next steps:
Previous runReviewFindingsHigh
Low
Next steps:
Previous run (2)ReviewFindingsHigh
Low
Next steps:
Previous run (3)ReviewFindingsHigh
Low
Next steps:
Previous run (4)ReviewFindingsHigh
Low
Next steps:
Previous run (5)ReviewFindingsHigh
Low
Next steps:
|
August was only on /archived-roadmaps while the sidebar still opened the old combined file, so August never appeared. Put July, June, and Foundation next to August as dated files under archived-roadmaps/. Assisted-by: Cursor Grok 4.6 Signed-off-by: Adam Scerra <ascerra@redhat.com> Co-authored-by: Cursor <cursoragent@cursor.com>
|
🤖 Finished Review · ✅ Success · Started 10:56 AM UTC · Completed 11:11 AM UTC Commit: Runtime: claude · Model: opus → claude-opus-4-6 · Effort: high · Cost: $4.84 |
Bring the September roadmap branch onto current main. Assisted-by: Cursor Grok 4.6 Signed-off-by: Adam Scerra <ascerra@redhat.com> Co-authored-by: Cursor <cursoragent@cursor.com>
Call out ADR 0044 for leftover per-org cleanup, and drop unrelated prettier-only VitePress config churn. Assisted-by: Cursor Grok 4.6 Signed-off-by: Adam Scerra <ascerra@redhat.com> Co-authored-by: Cursor <cursoragent@cursor.com>
|
🤖 Finished Review · ✅ Success · Started 11:19 AM UTC · Completed 11:36 AM UTC Commit: Runtime: claude · Model: opus → claude-opus-4-6 · Effort: high · Cost: $7.13 |
waynesun09
left a comment
There was a problem hiding this comment.
One documentation-accuracy finding inline on docs/roadmap.md.
Give standing user-support work its own last-place theme, and label August Jira leftovers as issues vs ADR PRs per review. Assisted-by: Cursor Grok 4.6 Signed-off-by: Adam Scerra <ascerra@redhat.com> Co-authored-by: Cursor <cursoragent@cursor.com>
|
🤖 Finished Review · ✅ Success · Started 8:22 PM UTC · Completed 8:36 PM UTC Commit: Runtime: claude · Model: opus → claude-opus-4-6 · Effort: high · Cost: $4.57 |
waynesun09
left a comment
There was a problem hiding this comment.
Automated review sweep — inline findings below, plus one finding on an unchanged line the diff doesn't cover:
docs/.vitepress/config.ts (line 442, outside diff hunks)
[MEDIUM] archived-roadmaps folder is entirely absent from VitePress search scopes (overcorrection from an earlier review round)
Verified via git history on this PR: commit 34086ff (the PR's first commit) added "/docs/archived-roadmaps/" to the Contributing scope's prefixes array, which drew a qodo-code-review[bot] comment (id 3910157431, orig_line 442) calling that a misclassification (archived pages showing up under the live "Contributing" filter). A later commit, cd5ecbbb, responded by removing "/docs/archived-roadmaps/" from the Contributing prefixes entirely rather than moving it to its own scope. On the current head (22cab23), search.options.scopes lists Guides, Design Docs, Experiments, Contributing (["/docs/contributing/"] only), and a catch-all Others — /docs/archived-roadmaps/ appears in no scope's prefix list. The archived pages are still placed under "Contributing" in the sidebar navigation (config.ts ~line 368-370), so with the Contributing search pill active, the archived roadmap pages are now unreachable there and only surface under the generic "Others" scope — inconsistent with their sidebar placement. This is a different, currently-live defect from the one the earlier bot comment flagged (which described the opposite state and was already addressed by the intervening commit), so no existing comment covers it. Note: line 442 (the unchanged scopes array) falls outside this PR's diff hunks, so this finding is included in the review body rather than as an inline comment.
Suggestion: Add "/docs/archived-roadmaps/" to an appropriate scopes entry — either a new dedicated scope (e.g. "Archived Roadmaps") or back into Contributing's prefixes if that classification is intended — so local search matches the sidebar placement, without reintroducing the earlier misclassification-under-Contributing complaint if a dedicated scope is used instead.
Add the open scheduled/nightly agent docs PR from planning feedback to the standing User support theme. Assisted-by: Cursor Grok 4.6 Signed-off-by: Adam Scerra <ascerra@redhat.com> Co-authored-by: Cursor <cursoragent@cursor.com>
|
🤖 Finished Review · ✅ Success · Started 4:46 PM UTC · Completed 5:00 PM UTC Commit: Runtime: claude · Model: opus → claude-opus-4-6 · Effort: high · Cost: $4.67 |
Resolve conflicts and address open review findings: drop the wrong #6464 link, redirect archived-roadmap with canonical SEO, and narrow the lychee exclude to the fragment-heavy July archive page. Assisted-by: Cursor Grok 4.6 Signed-off-by: Adam Scerra <ascerra@redhat.com> Co-authored-by: Cursor <cursoragent@cursor.com>
|
🤖 Finished Review · ✅ Success · Started 12:15 AM UTC · Completed 12:33 AM UTC Commit: Runtime: claude · Model: opus → claude-opus-4-6 · Effort: high · Cost: $6.26 |
| @@ -117,7 +120,12 @@ export function pageRobotsHead(page: string): HeadConfig[] { | |||
| */ | |||
| export function isSitemapUrl(url: string): boolean { | |||
There was a problem hiding this comment.
[low] API shape patterns
Three SEO functions reference the archived-roadmap page using different string forms: archived-roadmap.md in isIndexablePage and pageRobotsHead, but archived-roadmap and archived-roadmap.html in isSitemapUrl. The different forms match their respective input formats (page paths vs sitemap URLs), but extracting a shared stem constant would reduce coordination cost for future renames.
Suggested fix: Optional: extract a stem constant and derive each form programmatically.
Summary
docs/archived-roadmaps/plus an index.docs/archived-roadmap.mdis a meta-refresh + canonical redirect toarchived-roadmaps/(same pattern asdocs/index.md).Deprecated per-org (ADR 0044)
This PR mentions leftover cleanup from deprecated per-org installation mode (ADR 0044), tracked as fullsend#2887. That is remaining teardown, not new org-mode architecture.
Protected path
.pre-commit-config.yaml/Makefilelychee--exclude-pathis narrowed todocs/archived-roadmaps/2026-07.mdonly (the fragment-heavy historical page). README and other dated archives stay link-checked. Needs human approval for the protected-path change.Test plan
/archived-roadmapredirects to/archived-roadmaps/and sidebar lists dated editions newest first.Made with Cursor