Skip to content

Add MCPRegistry CRD deprecation notices#926

Merged
ChrisJBurns merged 1 commit into
mainfrom
pr-5470-deprecation-notices-for-docs
Jun 9, 2026
Merged

Add MCPRegistry CRD deprecation notices#926
ChrisJBurns merged 1 commit into
mainfrom
pr-5470-deprecation-notices-for-docs

Conversation

@ChrisJBurns

Copy link
Copy Markdown
Contributor

Description

The MCPRegistry CRD is deprecated and superseded by the toolhive-registry-server Helm chart, which installs the Registry Server directly. The CRD remains fully functional for now but will be removed in a future release.

This adds user-facing deprecation notices in the registry section, in the two spots recommended by the maintainer:

  • guides-registry/deployment.mdx (deployment landing page): reordered the methods table to lead with Helm and tagged the ToolHive Operator row as (deprecated); added a top-level warning callout; added a per-section warning under ToolHive Operator; reordered Next steps so Helm is recommended first and the Operator (deprecated) last.
  • guides-registry/deploy-operator.mdx (CRD-specific page): added a prominent warning admonition after the front matter noting the CRD is deprecated, that kubectl and the operator now emit deprecation warnings, and that new deployments should use Helm while existing deployments keep working.

Type of change

  • Documentation update

Related issues/PRs

Submitter checklist

Content and formatting

  • I have reviewed the content for technical accuracy
  • I have reviewed the content for spelling, grammar, and style

🤖 Generated with Claude Code

The MCPRegistry CRD is superseded by the toolhive-registry-server Helm
chart. Add deprecation warnings to the registry deployment landing page
and the operator deploy guide, and steer new deployments toward Helm.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Copilot AI review requested due to automatic review settings June 9, 2026 21:47
@vercel

vercel Bot commented Jun 9, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
docs-website Ready Ready Preview, Comment Jun 9, 2026 9:48pm

Request Review

Copilot AI 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.

Pull request overview

Adds user-facing documentation warnings that the MCPRegistry CRD (ToolHive Operator deployment method for the Registry Server) is deprecated in favor of the toolhive-registry-server Helm chart, helping readers choose the recommended deployment path while the CRD remains functional.

Changes:

  • Reorders deployment options to lead with Helm and labels the ToolHive Operator method as deprecated.
  • Adds prominent warning admonitions on both the deployment landing page and the operator-specific guide.
  • Updates “Next steps” ordering to recommend Helm first and the deprecated operator flow last.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 2 comments.

File Description
docs/toolhive/guides-registry/deployment.mdx Adds deprecation warning context, reorders the deployment methods, and updates navigation to steer new installs to Helm.
docs/toolhive/guides-registry/deploy-operator.mdx Adds a prominent deprecation warning explaining the new runtime/API warnings and pointing readers to the Helm-based deployment.

Comment thread docs/toolhive/guides-registry/deployment.mdx
Comment thread docs/toolhive/guides-registry/deploy-operator.mdx
@ChrisJBurns ChrisJBurns merged commit ae7b997 into main Jun 9, 2026
10 checks passed
@ChrisJBurns ChrisJBurns deleted the pr-5470-deprecation-notices-for-docs branch June 9, 2026 21:54
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.

3 participants