Skip to content

fix: regen feature stage docs from HEAD & enforce generation#26528

Open
zedkipp wants to merge 1 commit into
mainfrom
zedkipp/feature-stages-from-head
Open

fix: regen feature stage docs from HEAD & enforce generation#26528
zedkipp wants to merge 1 commit into
mainfrom
zedkipp/feature-stages-from-head

Conversation

@zedkipp

@zedkipp zedkipp commented Jun 18, 2026

Copy link
Copy Markdown
Contributor

Generate the experimental and beta tables in docs/install/releases/feature-stages.md from the current source tree instead of release tags + GitHub API.

  • Read experiments from ./codersdk via go doc.
  • Read beta features from docs/manifest.json directly.
  • Drop the "Available in" column because per-version docs already convey channel availability
  • Key beta dedup on path so the tasks-to-chats-migration entry no longer shows up twice.
  • Format in the Makefile rule in a way that matches the other docs/* gen rules.
  • Wire docs/install/releases/feature-stages.md into GEN_FILES and gen/mark-fresh so make gen (and CI's gen job) keeps it fresh.

This change was assisted by Coder Agents.

@github-actions

Copy link
Copy Markdown

Docs preview

📖 View docs preview for docs/install/releases/feature-stages.md

@datadog-coder

datadog-coder Bot commented Jun 18, 2026

Copy link
Copy Markdown

Pipelines

⚠️ Warnings

🚦 1 Pipeline job failed

weekly-docs | audit-docs-paths   View in Datadog   GitHub Actions

This comment will be updated automatically if new data arrives.
🔗 Commit SHA: 8111cf7 | Docs | Give us feedback!

@zedkipp zedkipp changed the title chore(scripts/release): regenerate feature-stages.md from HEAD fix: regen feature stage docs from HEAD & enforce generation Jun 18, 2026
@zedkipp zedkipp force-pushed the zedkipp/feature-stages-from-head branch 2 times, most recently from b03f496 to dfdc8d1 Compare June 18, 2026 18:20
Drive the experimental and beta tables in docs/install/releases/feature-stages.md from the current source tree instead of release tags + GitHub API.

- Read experiments from ./codersdk via `go doc`.
- Read beta features from docs/manifest.json directly.
- Drop the "Available in" column (per-version docs already convey channel
  availability) so the file becomes a pure function of HEAD.
- Key beta dedup on path so the tasks-to-chats-migration entry no longer
  shows up twice.
- Format via markdownlint-cli2 --fix + markdown-table-formatter in the
  Makefile rule, matching the other docs/* gen rules.
- Wire docs/install/releases/feature-stages.md into GEN_FILES and
  gen/mark-fresh so `make gen` (and CI's gen job) keeps it fresh.

This change was authored with Coder Agents.
@zedkipp zedkipp force-pushed the zedkipp/feature-stages-from-head branch from dfdc8d1 to 8111cf7 Compare June 18, 2026 19:42
@zedkipp zedkipp requested review from bpmct, jakehwll and matifali June 18, 2026 20:01
@zedkipp zedkipp marked this pull request as ready for review June 18, 2026 20:01
Comment on lines +107 to +115
| [Debug Data Retention](../../ai-coder/agents/platform-controls/chat-debug-retention.md) | Automatic cleanup of old chat debug data |
| [MCP Servers](../../ai-coder/agents/platform-controls/mcp-servers.md) | Configure external MCP servers that provide additional tools for agent chat sessions |
| [Chat Sharing](../../ai-coder/agents/chat-sharing.md) | Share Coder Agents conversations with users and groups |
| [Experiments](../../ai-coder/agents/platform-controls/experiments.md) | Experimental Coder Agents features admins can opt in to: virtual desktop, advisor, and chat debug logging |
| [Architecture](../../ai-coder/agents/architecture.md) | How the agent in the control plane communicates with workspaces |
| [Git Providers](../../ai-coder/agents/platform-controls/git-providers.md) | Git provider configuration for the in-chat diff viewer |
| [Tasks to Chats API Migration](../../ai-coder/agents/tasks-to-chats-migration.md) | Guide for migrating from the Tasks API to the Chats API |
| [Data Retention](../../ai-coder/agents/platform-controls/chat-retention.md) | Automatic cleanup of old conversation data |
| [Models](../../ai-coder/agents/models.md) | Configure LLM providers and models for Coder Agents |

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

I think all of them should be bundled under Agents. Maybe we need to remove the Beta label from child pages in Manifest or just ignore that if the parent has that label too.
The current list is not very useful.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

What do you mean by "under agents"? List the agents-specific beta features on some Coder Agent's docs page?

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

image.png

Coder Agents is a parent page that has Beta label along with all its child pages.
SO when a parent has beta we should ignore all childern

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

"state": ["beta"],


All its children should be ignored.

Comment on lines +118 to +119
| [Getting Started](../../ai-coder/agents/getting-started.md) | Enable Coder Agents, prepare your deployment, and run your first Coder Agent |
| [Search Syntax](../../ai-coder/agents/chat-search-syntax.md) | Filter conversations by title, status, and linked pull requests |

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

This also belongs to Agents

Comment on lines +121 to +127
| [Spend Management](../../ai-coder/agents/platform-controls/usage-insights.md) | Spend limits and cost tracking for Coder Agents |
| [Platform Controls](../../ai-coder/agents/platform-controls/index.md) | How platform teams control agent behavior, models, and policies |
| [Template Optimization](../../ai-coder/agents/platform-controls/template-optimization.md) | Best practices for creating templates that are discoverable and useful to Coder Agents |
| [Auto-Archive](../../ai-coder/agents/platform-controls/chat-auto-archive.md) | Automatic archiving of inactive conversations |
| [Extending Agents](../../ai-coder/agents/extending-agents.md) | Add custom skills and MCP tools to agent workspaces |
| [Coder Agents](../../ai-coder/agents/index.md) | Self-hosted agent by Coder |
| [Tools](../../ai-coder/agents/tools/index.md) | How Coder Agents uses tool calls to select templates and create workspaces |

@matifali matifali Jun 18, 2026

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

these too are child pages of agents

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.

2 participants