Thanks to visit codestin.com
Credit goes to github.com

Skip to content

docs: add Licensing & Usage page and reorder agents manifest - #28263

Merged
mattvollmer merged 13 commits into
mainfrom
matt/agents-licensing
Aug 18, 2026
Merged

docs: add Licensing & Usage page and reorder agents manifest#28263
mattvollmer merged 13 commits into
mainfrom
matt/agents-licensing

Conversation

@mattvollmer

Copy link
Copy Markdown
Contributor

Adds a new Licensing & Usage page under docs/ai-coder/agents/ covering the difference between Community and AI Premium licenses, how Agent Time is measured, and what happens when concurrency or usage limits are reached.

Reorders the Coder Agents section in docs/manifest.json to the following sequence: Getting Started, Architecture, Platform Controls, Extending Agents, Models, Tools, Chat Sharing, Search Syntax, Licensing & Usage, Tasks to Chats API Migration.


PR generated with Coder Agents

@github-actions

github-actions Bot commented Aug 18, 2026

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 changed the title docs(agents): add Licensing & Usage page and reorder agents manifest docs: add Licensing & Usage page and reorder agents manifest Aug 18, 2026
@mattvollmer
mattvollmer marked this pull request as ready for review August 18, 2026 15:10
@coderagents

coderagents Bot commented Aug 18, 2026

Copy link
Copy Markdown
Contributor

Documentation Check

This is a docs-only PR, and the new page is well structured and correctly wired into docs/manifest.json. The exhaustion-behavior conflict has been resolved by trimming that section; two consistency items remain.

Updates Needed

  • docs/ai-coder/agents/licensing-usage.md - Terminology mismatch. This page uses "Agent Time" throughout, but the rest of the Coder Agents docs use "Agent Hours" (getting-started.md lines 228-230, platform-controls/index.md lines 126-129). Pick one canonical term and align all pages so the docs don't describe the same billing unit under two names.
  • docs/ai-coder/agents/licensing-usage.md - Exhaustion behavior conflicts with existing docs. This page says an AI Premium deployment that exhausts its allocation "may be provisioned to fall back to the Community concurrency model" (five concurrent, extras queued), which conflicts with the hard-limit behavior in platform-controls/index.md and getting-started.md. Resolved in ded1120: the two directly conflicting sentences were removed from the "AI Premium Agent Time exhaustion" section.

    ⚠️ The remaining sentence still refers to "the concurrency fallback" without describing the "Agent Hours hard limit" mechanism that the other pages use. Consider linking to Concurrent agents for the full behavior.

New Documentation Needed

  • docs/reference/glossary.md - The usage-billing concept ("Agent Time" / "Agent Hours") is a user-facing Coder Agents feature name but has no glossary entry. Add one once the canonical term is settled.

Automated review via Coder Agents

@nickvigilante nickvigilante 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.

Overall, LGTM. A few nits and one open question, but once that question is resolved, I'll approve. Thanks for this!

Comment thread docs/ai-coder/agents/licensing-usage.md Outdated
Comment thread docs/ai-coder/agents/licensing-usage.md Outdated
Comment thread docs/ai-coder/agents/licensing-usage.md Outdated
Comment thread docs/ai-coder/agents/licensing-usage.md Outdated
Comment thread docs/ai-coder/agents/licensing-usage.md Outdated
Comment thread docs/ai-coder/agents/licensing-usage.md
Comment thread docs/ai-coder/agents/licensing-usage.md Outdated
Comment thread docs/ai-coder/agents/licensing-usage.md Outdated
Comment thread docs/ai-coder/agents/licensing-usage.md Outdated
Comment thread docs/ai-coder/agents/licensing-usage.md Outdated
@mattvollmer
mattvollmer enabled auto-merge (squash) August 18, 2026 19:05

@nickvigilante nickvigilante 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.

Awesome stuff :shipit: 🚀

@mattvollmer
mattvollmer merged commit 5f6eeda into main Aug 18, 2026
29 checks passed
@mattvollmer
mattvollmer deleted the matt/agents-licensing branch August 18, 2026 19:19
@github-actions github-actions Bot locked and limited conversation to collaborators Aug 18, 2026
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants