Skip to content

docs: rename Early Access to Beta and remove early-access page#24826

Merged
david-fraley merged 1 commit into
mainfrom
dfraley/docs-agents-beta
May 5, 2026
Merged

docs: rename Early Access to Beta and remove early-access page#24826
david-fraley merged 1 commit into
mainfrom
dfraley/docs-agents-beta

Conversation

@david-fraley
Copy link
Copy Markdown
Collaborator

@david-fraley david-fraley commented Apr 29, 2026

Closes CODAGT-157 (in part).

Coder Agents is moving from Early Access to Beta for the May release. This PR:

  1. Renames every “Early Access” reference in the /agents docs to “Beta” (prose, manifest nav titles, and state badges).
  2. Deletes the standalone docs/ai-coder/agents/early-access.md page and its nav entry. The Beta positioning stays in place via the existing Product status section in index.md and the lead callout in getting-started.md.

Scope

  • Deleted: docs/ai-coder/agents/early-access.md (whole page, 85 lines).
  • Updated: docs/ai-coder/agents/index.md — “Product status” paragraph: drop the link to the deleted page; keep the Beta sentence.
  • Updated: docs/ai-coder/agents/getting-started.md — lead [!NOTE] callout, “Things to know” paragraph, and the redundant “See [Enable Coder Agents]” pointer (Step 1 already inlines the same CODER_EXPERIMENTS instructions).
  • Updated: docs/manifest.json — 14 state badges flipped to beta; removed the “Early Access” nav entry that pointed to the deleted page.

Unrelated "early access" entries elsewhere in the manifest (User Secrets, External Workspaces, Startup Dependencies, AI Gateway MCP Tools Injection) are intentionally untouched.

What we lose by deleting the page

Flagging this so reviewers can decide:

  • The “What Beta does not include” list (no SLA, no stability guarantees, etc.).
  • The Beta-to-GA licensing notice.
  • The standalone enablement walkthrough that ´getting-started.md´ already covers.
  • The “Providing feedback” paragraph (also covered in getting-started.md).

If any of this needs to live somewhere, happy to migrate it into getting-started.md or index.md in a follow-up.

URLs

Deleting the file removes /docs/ai-coder/agents/early-access. The redirect to /agents/getting-started (or /agents/) belongs in the coder.com docs site config, not this repo. I will open the corresponding redirect PR there separately.

Proof

This is a docs-text change with no behavior change. Visible string diffs:

index.md — Product status section, link removed

 Coder Agents is in Beta. The feature is under active development and
-available for evaluation. See [Beta](./early-access.md) for
-enablement instructions and program details.
+available for evaluation.

getting-started.md — lead callout, link removed

 > [!NOTE]
-> Coder Agents is in [Beta](./early-access.md). Deploy to a
+> Coder Agents is in Beta. Deploy to a
 > **test or development environment** — not production — while evaluating
 > the feature.

getting-started.md — redundant “See [Enable Coder Agents]” pointer dropped

 CODER_EXPERIMENTS="agents,oauth2,mcp-server-http" coder server

-See Enable Coder Agents for full
-details.

Step 2: Configure an LLM provider and model


**`manifest.json` — nav entry removed**

```diff
 {
     "title": "Getting Started",
     ...
 },
-{
-    "title": "Beta",
-    "description": "About the Coder Agents Beta program",
-    "path": "./ai-coder/agents/early-access.md",
-    "state": ["beta"]
-},
 {
     "title": "Architecture",
     ...
 }

Screenshots of the rendered Beta pages from before the deletion are attached to the chat. After this PR the standalone Beta page is gone, so the in-product proof is the unchanged Beta badges in the navigation and the surviving Beta callout in getting-started.md.

Validation

  • pnpm exec markdownlint-cli2 docs/ai-coder/agents/index.md docs/ai-coder/agents/getting-started.md → 0 errors
  • python3 -m json.tool docs/manifest.json → valid JSON
  • bash scripts/check_emdash.sh → OK, no new emdash/endash characters
  • grep -rn -E "early.access|early-access" docs/ai-coder/agents/ docs/manifest.json → only the four unrelated state: ["early access"] matches outside /agents, intentionally untouched

Follow-ups (out of scope here)

  • Redirect from /docs/ai-coder/agents/early-access to /docs/ai-coder/agents/getting-started in the coder.com docs site repo.
  • The deeper docs audit against the Chats API implementation (auto-archive default, missing endpoints, missing attach_file tool, etc.) is tracked separately and will be a follow-up PR against CODAGT-157.

Coder Agent generated this PR on @david-fraley's behalf.

@github-actions
Copy link
Copy Markdown

Docs preview

📖 View docs preview

@david-fraley david-fraley changed the title docs(docs/ai-coder/agents): rename Early Access to Beta docs(docs/ai-coder/agents): rename Early Access to Beta and remove early-access page Apr 29, 2026
@david-fraley david-fraley changed the title docs(docs/ai-coder/agents): rename Early Access to Beta and remove early-access page docs: rename Early Access to Beta and remove early-access page Apr 29, 2026
@david-fraley david-fraley force-pushed the dfraley/docs-agents-beta branch from c31ab61 to a5cfdee Compare April 30, 2026 21:22
Copy link
Copy Markdown
Collaborator Author

Rebased onto current main and reset to a clean state. Force-pushed a5cfdee46.

Key changes from the previous head:

Pre-commit-light passed locally (6s):

✓ fmt/markdown
✓ lint/emdash
✓ lint/typos
✓ lint/markdown
✓ pre-commit-light passed

Diff stat:

docs/ai-coder/agents/early-access.md    | 70 ---------------------------------
docs/ai-coder/agents/getting-started.md | 10 ++---
docs/ai-coder/agents/index.md           |  5 +--
docs/manifest.json                      | 34 +++++++---------
4 files changed, 20 insertions(+), 99 deletions(-)

The 4 unrelated state: ["early access"] entries (User Secrets, External Workspaces, Startup Dependencies, AI Gateway MCP Tools Injection) are intentionally untouched.

The companion redirect for /docs/ai-coder/agents/early-access was added in coder/coder.com#731.

This is Coder Agents responding on @david-fraley's behalf.

Coder Agents is moving from Early Access to Beta for the May release.

- Delete docs/ai-coder/agents/early-access.md.
- Update getting-started.md and index.md to use Beta wording and drop
  the link to the deleted page. The CODER_EXPERIMENTS=agents flag setup
  was already removed in #24432; no further changes needed there.
- Reframe the lead callout and the 'Things to know before you start'
  section to reflect that Beta features are supported in production;
  the caveat is API/behavior change between releases, not stability.
- Flip 14 manifest state badges in /agents/ to beta and remove the
  Early Access nav entry.

The 4 unrelated state: ["early access"] entries elsewhere in the
manifest (User Secrets, External Workspaces, Startup Dependencies,
AI Gateway MCP Tools Injection) are intentionally untouched.
@david-fraley david-fraley force-pushed the dfraley/docs-agents-beta branch from a5cfdee to 19c4b0d Compare April 30, 2026 21:30
Copy link
Copy Markdown
Collaborator Author

Pushed 19c4b0d84. One more change per @david-fraley: Beta features are supported in production, so the previous "deploy to test or dev only" framing was wrong.

Reframed two sections in getting-started.md:

  • Lead [!NOTE] callout — dropped the "deploy to test or development" wording. The Beta caveat is that APIs, behavior, and configuration may change between releases, so the new callout asks readers to pin a release before broad rollout.
  • "Things to know before you start" — renamed the section from "Deploy to a non-production environment" to "Plan for change between releases". Same underlying point (changes between releases), but doesn't prohibit production use.

Diff stat updated:

docs/ai-coder/agents/early-access.md    | 70 ---------------------------------
docs/ai-coder/agents/getting-started.md | 14 ++++----
docs/ai-coder/agents/index.md           |  5 +--
docs/manifest.json                      | 34 +++++++---------
4 files changed, 24 insertions(+), 103 deletions(-)

Pre-commit-light passed locally.

This is Coder Agents responding on @david-fraley's behalf.

david-fraley added a commit that referenced this pull request Apr 30, 2026
- Drop CODER_EXPERIMENTS=agents references; the flag was removed by #24432
- Keep 'coder exp agents' per @david-fraley's direction (the API is still
  experimental) even though #24432 also graduated the CLI to 'coder agents'
- Repoint chats-api.md link to ../../reference/api/chats.md (deletion in #24830)
- Flip manifest state to beta to match the rest of /agents/ post-#24826
- Clarify that 'waiting' is both the initial idle state and the post-
  completion idle state in the status mapping table
@david-fraley david-fraley merged commit 1611862 into main May 5, 2026
26 checks passed
@david-fraley david-fraley deleted the dfraley/docs-agents-beta branch May 5, 2026 12:59
@github-actions github-actions Bot locked and limited conversation to collaborators May 5, 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.

2 participants