Skip to content

Map feature availability and badge every gated feature - #1194

Draft
gwenwindflower wants to merge 2 commits into
mainfrom
docs/feature-availability-map
Draft

Map feature availability and badge every gated feature#1194
gwenwindflower wants to merge 2 commits into
mainfrom
docs/feature-availability-map

Conversation

@gwenwindflower

Copy link
Copy Markdown
Contributor

What

Adds support/feature-availability — a map of every gated feature and what it takes to reach it — and makes the badges on individual pages agree with it.

The prompt was that write-back looked ungated if you landed on it directly, even though it needs agents. That turned out to be true across most of the agents tree: only the section root carried a gate, so any page reached from search or a deep link read as free.

Changes

  • New map page in support/, the availability counterpart to feature maturity levels. Three tables — AI, administration and governance, data and platform — plus how features get turned on in Cloud versus self-hosted.
  • New AI add-on badge (sparkles). The add-on is purchasable on any Cloud plan, so it is not an Enterprise plan tier and had no representable value before. Added to .mintlify/components.md alongside the other three.
  • snippets/ai-add-on-availability.mdx transcluded across 11 agents pages, so the gate has one home and cannot drift.
  • Bold-prose gates converted to badges on custom roles, service accounts, SCIM, verified domains, organization credentials, homepage, project chart types, caching, data apps, embedding, MCP, and scheduled deliveries — each linking the map and, where relevant, naming the self-host env flag.
  • AI writeback and dbt write-back are now clearly separate. The AI one needs the add-on; the one in the Custom Metric and SQL Runner menus is gated by project role and available to any Developer.

Notes for review

Two plan claims are inherited from the existing pages and worth a second pair of eyes, since nothing in the backend models plans:

  • agents/thread-retention carries Enterprise, but structurally it looks like a feature flag inside the add-on.
  • Autopilot and Issues say "Cloud Pro and above".

mint broken-links is clean apart from two pre-existing /api-reference/scim/list-users failures, which come from the OpenAPI spec being unreachable in this environment rather than from this change.

🤖 Generated with Claude Code

https://claude.ai/code/session_017wffdQdvDJWRLQMZr3Vpfs

@mintlify

mintlify Bot commented Aug 27, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
lightdash 🟢 Ready View Preview Aug 27, 2026, 10:44 PM

@github-actions

github-actions Bot commented Aug 27, 2026

Copy link
Copy Markdown
Contributor

Documentation validation

✅ All blocking checks passed.

Component system

0 finding(s) across the corpus.

Findings on lines this pull request touched are annotated inline in Files changed.

Download the structured JSON artifact.

gwenwindflower and others added 2 commits August 27, 2026 18:23
* Map every gated feature to what it needs — Enterprise, the AI add-on, Cloud, or self-hosted — as the availability counterpart to feature maturity levels.
* Add an AI add-on badge so the add-on axis is representable, since it is purchasable on any Cloud plan rather than tied to a plan tier.
* Add a reusable AI add-on gate snippet for the agents tree.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017wffdQdvDJWRLQMZr3Vpfs
* Gate the whole agents tree with the AI add-on snippet, so pages reached directly — AI writeback, agent context, data access — no longer read as ungated.
* Convert bold-prose availability gates to badges across admin, explore, and semantic layer pages, each linking the availability map.
* Separate AI writeback from dbt write-back, which is gated by project role rather than by plan.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017wffdQdvDJWRLQMZr3Vpfs
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