docs: showcase feedback, roadmap, and changelog sections

[leoisadev1]

What

Rebuilds the public Fumadocs content so the three core products lead the docs, with real subcategory structure, screenshot placeholders, and an agent docs-sync convention.

Docs content

• Three nested sections with their own meta.json sidebar groups:
  • feedback/ — overview, collecting (portal/SDK/REST/imports/composer), triaging
  • roadmap/ — overview, managing the board, public roadmap
  • changelog/ — overview, writing & publishing, AI drafting
• Root meta.json regrouped with Products / Concepts / Integrate / Operate separators; existing pages kept.
• index.mdx now leads with the three products.

Screenshot placeholders

• New Screenshot component renders a captioned figure frame now and swaps to a real image the moment src is passed (loading="lazy", object-cover). ~13 placed across the pages.

Agent docs-sync convention

• AGENTS.md (root) gains a Documentation Sync rule.
• apps/fumadocs/AGENTS.md carries the feature → doc-page map and the remaining gaps, so future feature changes keep these pages current.

Accuracy

All API/SDK/CLI details verified against source (roadmapStatusToRoadmapStatus, AmendChangelogEntryInput, AmendChangelogDraftInput). Roadmap API-status → board-column mapping and the changelog summary (editor-derived vs API-set) are documented explicitly.

Review

Five local Greptile passes; all findings resolved (roadmap status conflation, changelog summary contradiction, duplicate caption, lazy-load + object-fit, REST auth note, stub example, stale agent map).

Validation

bun run check-types (MDX generation + tsc) and oxlint pass.

---

Created with PostHog Code

[greptile-apps]

Greptile Summary

Rebuilds the Fumadocs public docs around the three core products \u2014 Feedback, Roadmap, and Changelog \u2014 each with its own nested section, meta.json sidebar group, and content pages. A new Screenshot placeholder component is introduced so pages read as designed before real images arrive.

• Three new doc sections (feedback/, roadmap/, changelog/) add 9 MDX pages covering intake paths, triaging, board management, public roadmap, writing/publishing, and AI drafting.
• Screenshot component renders a captioned placeholder frame until src is supplied; two minor gaps exist in the placeholder state (missing ARIA role) and the image path (no width/height attributes).
• Agent convention additions in AGENTS.md and apps/fumadocs/AGENTS.md give future automated agents a precise feature\u2192doc-page map.

Confidence Score: 4/5

Safe to merge — all changes are docs content and a small React component; no application logic, routing, or API behaviour is modified.

The only shipped code is the Screenshot component, which has two small gaps: the placeholder div is missing an ARIA role/label, and the real-image path omits width/height attributes. Neither causes a functional regression on a docs site. Documentation content is internally consistent and source-verified.

apps/fumadocs/src/components/screenshot.tsx — the two accessibility and CLS notes are worth a quick pass before real images are wired in, since fixing them later means touching every call site.

Important Files Changed

Filename	Overview
apps/fumadocs/src/components/screenshot.tsx	New figure/placeholder component — placeholder div lacks ARIA role/label for screen readers; real-image path missing width/height attributes (minor CLS risk).
apps/fumadocs/src/components/mdx.tsx	One-line wiring of the new Screenshot component into the global MDX components map — straightforward and correct.
AGENTS.md	Adds a Documentation Sync rule pointing agents to the feature→doc-page map in apps/fumadocs/AGENTS.md — clear and well scoped.
apps/fumadocs/AGENTS.md	New agent guideline file mapping every feature area to its owning doc page, listing gaps, and defining style rules — well structured and accurate to the repo layout.
apps/fumadocs/content/docs/feedback/collecting.mdx	Documents all five intake paths with accurate code examples; REST auth claim matches SDK no-token-for-customer-writes pattern.
apps/fumadocs/content/docs/roadmap/managing.mdx	Correctly documents API status → board column mapping table and upsertRoadmapItem usage; internally consistent.
apps/fumadocs/content/docs/changelog/ai-drafting.mdx	Accurately documents SDK draftChangelog, REST POST /drafts (owner token required), and CLI draft command with dryRun support.
apps/fumadocs/content/docs/meta.json	Adds Products/Concepts/Integrate/Operate separator groups and registers the three new section folders; all existing pages preserved.
apps/fumadocs/content/docs/index.mdx	Adds three-product Cards section at the top; reorganizes setup links; Production routing card removed but page remains in sidebar.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    A[Customer Request] --> B[Feedback Intake]
    B --> B1[Portal Form]
    B --> B2[SDK submitRequest]
    B --> B3[REST POST /feedback]
    B --> B4[importFeedback bulk]
    B --> B5[Dashboard Composer]
    B1 & B2 & B3 & B4 & B5 --> C[Feedback Inbox]
    C --> D{Promote to Roadmap?}
    D -- Yes --> E[Roadmap Item]
    D -- No --> C
    E --> F[Board Columns]
    F --> G[Changelog Entry]
    G --> H{Publish?}
    H -- portal+email on --> I[Public Portal + Email]
    H -- off --> J[Internal Record]

Loading

_{Reviews (1): Last reviewed commit: "docs: flesh out draftChangelog example a..." | Re-trigger Greptile}

[greptile-apps]

The placeholder <div> has no ARIA role or label, so screen readers get no context — they see the badge text ("Screenshot") floating inside a generic container with no indication it represents an image. Adding role="img" and aria-label={alt ?? caption} turns the placeholder into an announced figure that assistive tech understands. Confidence this is a real issue: 4/5.

Suggested change

	<div
	className="flex flex-col items-center justify-center gap-2 bg-[repeating-linear-gradient(45deg,transparent,transparent_10px,color-mix(in_oklab,white_3%,transparent)_10px,color-mix(in_oklab,white_3%,transparent)_20px)] text-center"
	style={frameStyle}
	>
	<div
	role="img"
	aria-label={alt ?? caption}
	className="flex flex-col items-center justify-center gap-2 bg-[repeating-linear-gradient(45deg,transparent,transparent_10px,color-mix(in_oklab,white_3%,transparent)_10px,color-mix(in_oklab,white_3%,transparent)_20px)] text-center"
	style={frameStyle}
	>

Note: If this suggestion doesn't match your team's coding style, reply to this and let me know. I'll remember it for next time!

[greptile-apps]

The <img> element carries no width or height attributes. Even though the aspect-ratio CSS property reserves space, browsers can still emit a CLS hit on first paint before the stylesheet is applied (or when CSS is blocked). Defaulting to width={1600} (leaving height to the aspect-ratio style) would close most of the gap. Confidence this is a real issue: 3/5 — on a docs site the real-world CLS impact is low.

Note: If this suggestion doesn't match your team's coding style, reply to this and let me know. I'll remember it for next time!

[leoisadev1]

Closing as redundant: every file in this PR already merged to main via #23 (the docs SPA migration), including all the Greptile review fixes. Verified on origin/main — the three doc sections, the Screenshot component (with loading=lazy + object-cover, registered in the migrated SPA mdx provider), the AGENTS.md feature map, and the roadmap/changelog accuracy fixes are all present. This branch was based on pre-migration main, so merging would only add formatting noise.