Skip to content

docs: present AI Governance as included with Premium - #27545

Merged
mattvollmer merged 5 commits into
mainfrom
docs/ai-governance-included-in-premium
Jul 29, 2026
Merged

docs: present AI Governance as included with Premium#27545
mattvollmer merged 5 commits into
mainfrom
docs/ai-governance-included-in-premium

Conversation

@mattvollmer

@mattvollmer mattvollmer commented Jul 27, 2026 •
edited
Loading

Copy link
Copy Markdown
Contributor

Summary

AI Governance is now included with Premium licenses instead of being sold as a separate per-user add-on. This updates docs/ to describe the new packaging, removes "Add-On" from AI Governance references, and refreshes the editions architecture diagram.

Changes

  • docs/ai-coder/ai-governance.md: title is now "AI Governance"; rewrote the licensing statements (previously "a separate, per-user license... not included with a Premium subscription and must be purchased separately") to state it is included with Premium. The usage-pool section now attributes the shared Agent Workspace Build pool to Premium deployments.
  • Repeated admonition (28 files under ai-coder/agent-firewall/ and ai-coder/ai-gateway/): replaced "requires the AI Governance Add-On / as of Coder v2.32, deployments without the add-on..." with "is part of AI Governance, which is included with a Premium license." The v2.32 add-on gate no longer applies; the gate is now Premium vs. Community.
  • docs/ai-coder/index.md, security.md, tasks.md, usage-data-reporting.md, admin/licensing/index.md, install/releases/esr-2.29-2.34-upgrade.md, ai-gateway/ai-gateway-proxy/setup.md, ai-gateway/clients/claude-code.md: reworded add-on references to Premium inclusion.
  • docs/manifest.json: nav title "AI Governance Add-On" → "AI Governance", updated two descriptions, and swapped the 25 "state": ["ai governance add-on"] badges to ["premium"] so the sidebar badge reads "Premium" instead of "AI Governance Add-On".
  • docs/images/single-region-architecture.png: refreshed the diagram in the Community and Premium editions tab on Architecture. Also deleted the unreferenced single-region-architecture.svg copy.

Follow-ups outside this PR

  • The "ai governance add-on" doc-state badge is defined in coder/coder.com (src/utils/docs/state.ts). After this merges, no manifest entry uses that key, so it becomes dead config and can be removed there.
  • enterprise/coderd/license/license.go:564-572 still warns admins that "The AI Governance add-on is required to use AI Gateway." That backend string will contradict these docs once shipped.

Verification

  • pnpm run lint-docs: 0 errors across 504 files
  • make lint/emdash: clean
  • Vale on the changed Markdown files: 0 errors; remaining warnings are pre-existing gerund headings on untouched lines
  • docs/manifest.json validated as JSON
  • Confirmed the deleted SVG had no references anywhere in the repo

PR generated with Coder Agents on behalf of @mattvollmer.

@mattvollmer
docs: present AI Governance as included with Premium
ae1934b 
AI Governance is now included with Premium licenses instead of sold as a
separate per-user add-on. Update the docs to describe the new packaging:

- Rewrite the licensing statements on the AI Governance page, and drop
  "Add-On" from page and nav titles.
- Replace the repeated "requires the AI Governance Add-On / as of v2.32"
  admonition on AI Gateway and Agent Firewall pages with a note that the
  features are part of AI Governance and included with Premium.
- Swap the "ai governance add-on" manifest state badge for "premium".

References to the **AI add-on** column in the Users and Organization
Members tables are unchanged because they name product UI that still
uses that label.
@github-actions

github-actions Bot commented Jul 27, 2026 •
edited
Loading

Copy link
Copy Markdown
Contributor

Docs preview

Check off each page once it's been reviewed. If a page changes in a later push, its checkbox clears automatically so it gets a fresh look. Pages not yet wired into the docs navigation aren't listed here.

mattvollmer
mattvollmer commented Jul 27, 2026
View reviewed changes
Comment thread docs/ai-coder/ai-gateway/clients/claude-code.md Outdated
@mattvollmer
docs(docs/ai-coder/ai-gateway/clients): drop AI Governance from AI Ga…
388fe9c 
…teway comment
@mattvollmer
docs(docs/images): refresh community and premium architecture diagram
eda2492 
Update the single-region architecture diagram shown in the Community and
Premium editions tab, and remove the unreferenced SVG copy.
@mattvollmer
docs(docs/images): fix colors in community and premium architecture d…
286917b 
…iagram
@mattvollmer
mattvollmer requested a review from jcjiang July 28, 2026 17:15
jcjiang
jcjiang approved these changes Jul 28, 2026
View reviewed changes

@jcjiang jcjiang left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

All the changes make sense and I appreciate the comprehensiveness. Thanks for taking this on.

@mattvollmer
mattvollmer marked this pull request as ready for review July 28, 2026 18:03
@mattvollmer
mattvollmer requested a review from a team as a code owner July 28, 2026 18:03
@coderagents

coderagents Bot commented Jul 28, 2026

Copy link
Copy Markdown
Contributor

Documentation Check

Updates Needed

  • docs/install/airgap.md - The outbound-connections table still links to the "AI Governance Add On" (line 17). It is the only remaining docs/ page with add-on naming after this PR, so it should read "AI Governance" to match the new packaging.
  • docs/ai-coder/ai-governance.md - The "Identifying AI seat consumers" section now says the AI add-on column appears "When AI Governance is licensed", but commit dedde49b72 dropped the entitlement caveat. In code, shouldShowAISeatColumn (site/src/modules/dashboard/entitlements.ts:36-44) requires an entitled or grace-period ai_governance_user_limit feature, and FeatureAIGovernanceUserLimit is excluded from FeatureSetPremium because UsesLimit() is true (codersdk/deployment.go:296-301,356-366). A Premium license alone therefore does not surface the column unless the license explicitly grants that limit. Either restore a shortened caveat or reword so readers aren't told a Premium license guarantees the column.
  • docs/manifest.json - The Agent Firewall subpages edited in this PR (ai-coder/agent-firewall/nsjail/index.md, nsjail/docker.md, nsjail/k8s.md, nsjail/ecs.md, landjail.md, rules-engine.md, version.md) have no "state" badge, yet their new admonitions state the feature is Premium-only. Since this PR normalizes the badges for every other page in the set, add "state": ["premium"] to these entries for consistency.
  • docs/ai-coder/ai-governance.md - Per the doc-check premium-signaling rule, a page with "state": ["premium"] should also carry a (Premium) H1 suffix (# AI Governance (Premium)). Low priority and your call: 42 of 43 premium-badged pages in docs/ currently omit the suffix, so the convention is not enforced today. Flagging so the decision is explicit rather than accidental for the page that now defines the Premium framing.

Verified as accurate and complete otherwise:

  • All 26 "state": ["ai governance add-on"] manifest entries were converted; zero remain.
  • Every other docs/ page mentioning AI Governance was updated; no v2.32 add-on gate references survive.
  • The Premium-vs-Community gate claim matches enterprise/coderd/license/license.go, which entitles AI Gateway via the Premium feature set (the residual admin warning string at license.go:561-569 is already tracked in your PR description follow-ups).
  • The deleted docs/images/single-region-architecture.svg has no remaining references.
  • No emdash, endash, or -- punctuation introduced in the changed prose.

Automated review via Coder Agents

@mattvollmer
mattvollmer merged commit 4987afa into main Jul 29, 2026
38 of 39 checks passed
@mattvollmer
mattvollmer deleted the docs/ai-governance-included-in-premium branch July 29, 2026 12:45
@github-actions github-actions Bot locked and limited conversation to collaborators Jul 29, 2026
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Reviewers

@jcjiang jcjiang jcjiang approved these changes

Assignees

@mattvollmer mattvollmer

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

2 participants

@mattvollmer @jcjiang