Skip to content

docs(site): label roadmap features on the landing page - #100

Merged
kannandreams merged 1 commit into
mainfrom
docs/landing-page-roadmap-badges
Aug 28, 2026
Merged

docs(site): label roadmap features on the landing page#100
kannandreams merged 1 commit into
mainfrom
docs/landing-page-roadmap-badges

Conversation

@kannandreams

Copy link
Copy Markdown
Collaborator

Two features on the landing page carried a live status with no implementation behind them:

Claim Reality in src/glyf/
"Visual diff as a build artifact" — side-by-side diff against the previous build No match for visual_diff / visual-diff anywhere.
"Pipeline hooks and alerts" — Slack/webhook alerts with severity-based routing dashboard/macros/alert.py is a UI banner component (info / success / warning). No Slack, no webhooks, no routing.

Re-badging alone would have changed nothing

item.status was never rendered. All ten values were dead data, and the .featureStatus / .featureStatus--roadmap CSS was orphaned from an earlier layout — so every feature looked equally shipped regardless of its status string.

So this does three things:

  1. Renders the badge for roadmap items, reusing the existing CSS. .featureStoryName becomes a flex row to seat it next to the name.
  2. Fixes the prose, which is the part a visitor actually reads. Every roadmap description moves to the future tense — including the three that were already correctly badged (coming soon / soon) but still written in the present tense.
  3. Normalises the vocabulary: three values (live, coming soon, soon) for two concepts becomes live and roadmap.

Also drops a ✓ visual diff → artifacts/diff.html line from the git-diff mockup, which sat inside a shipped feature and asserted an unshipped one.

What is deliberately kept

The mockup visuals for roadmap items. With a Roadmap badge on the item and future-tense copy, they read as previews rather than claims — which is what they are.

Verified against the production build

Roadmap badges rendered: 5
  ROADMAP  Visual diff as a build artifact
  ROADMAP  Pipeline hooks and alerts
  ROADMAP  Generated React components
  ROADMAP  Agent-ready MCP server
  ROADMAP  Natural language chart edits
  live     dbt ref() in every chart
  live     Zero-server static output

All four old claim strings are absent from the built HTML. npm run build succeeds.

docs/integrations/overview.md already listed Slack/webhook alerting under "Planned integration areas" and needed no change — the docs were honest; only the landing page was not.

Two features carried a live status with no implementation behind them:
"Visual diff as a build artifact" (no visual diff code exists) and
"Pipeline hooks and alerts", whose Slack/webhook routing is actually a
dashboard banner component in dashboard/macros/alert.py.

Re-badging alone would have changed nothing, because item.status was
never rendered — all ten values were dead data, and the .featureStatus
CSS was orphaned from an earlier layout. So the badge is now rendered
for roadmap items, reusing that CSS, and every roadmap description moves
to the future tense, which is the part a visitor actually reads.

Also normalises three status values into two, and drops a "visual diff"
line from the git-diff mockup of a shipped feature, where it asserted an
unshipped one.

Mockups for roadmap items are kept: with a Roadmap badge on the item
they read as previews rather than claims.
@kannandreams
kannandreams merged commit fa1f710 into main Aug 28, 2026
5 checks passed
@kannandreams
kannandreams deleted the docs/landing-page-roadmap-badges branch August 28, 2026 22:03
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant