Skip to content

Add cross-references to Registry Server from existing docs#706

Merged
rdimitrov merged 3 commits intomainfrom
add-registry-server-crossrefs
Apr 13, 2026
Merged

Add cross-references to Registry Server from existing docs#706
rdimitrov merged 3 commits intomainfrom
add-registry-server-crossrefs

Conversation

@rdimitrov
Copy link
Copy Markdown
Member

Summary

Closes #366

  • Add :::tip[Host your own registry] admonitions to the UI and CLI registry guides, pointing users to the Registry Server when configuring remote registries
  • Add a :::note[Built-in registry vs. Registry Server] disambiguation to the registry criteria page
  • Add a paragraph and production-considerations bullet to the custom registry tutorial, noting the Registry Server as a complementary option
  • Add a mention of MCPRegistry resources to the Kubernetes Operator introduction

Skipped the main index.mdx insertion points from the issue because they already have prominent Registry Server cross-references (lines 125-131 in "ToolHive components").

Test plan

  • Verify all 6 new cross-reference links resolve correctly
  • Verify tip/note admonitions render properly on each page
  • Verify the insertions read naturally in context on each page
  • Confirm no regressions on surrounding content

🤖 Generated with Claude Code

Add inbound links to the Registry Server documentation from five
existing pages so users discover it at relevant points in their
journey. Adds tip admonitions to the UI and CLI registry guides,
a disambiguation note to registry criteria, a paragraph and bullet
to the custom registry tutorial, and a mention in the K8s operator
introduction.

Closes #366

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Copilot AI review requested due to automatic review settings April 13, 2026 21:00
@vercel
Copy link
Copy Markdown

vercel Bot commented Apr 13, 2026

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

Project Deployment Actions Updated (UTC)
docs-website Ready Ready Preview, Comment Apr 13, 2026 10:25pm

Request Review

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Adds inbound documentation cross-references so users configuring registries (or running ToolHive on Kubernetes) can discover the ToolHive Registry Server at the right decision points, and clarifies “built-in registry” vs “Registry Server” terminology.

Changes:

  • Adds :::tip[Host your own registry] admonitions to the UI and CLI registry guides linking to the Registry Server docs.
  • Adds a :::note[Built-in registry vs. Registry Server] disambiguation to the registry criteria concept doc.
  • Updates the custom registry tutorial and the Kubernetes Operator intro to mention the Registry Server as a complementary/production option.

Reviewed changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated 1 comment.

Show a summary per file
File Description
docs/toolhive/tutorials/custom-registry.mdx Adds Registry Server cross-reference in “Why…” and “Production considerations”.
docs/toolhive/guides-ui/registry.mdx Adds a tip pointing UI users to Registry Server for hosting remote registries.
docs/toolhive/guides-k8s/index.mdx Mentions Registry Server deployment/discovery via MCPRegistry resources.
docs/toolhive/guides-cli/registry.mdx Adds a tip pointing CLI users to Registry Server for hosting remote registries.
docs/toolhive/concepts/registry-criteria.mdx Adds a note clarifying built-in registry vs. Registry Server docs.

Comment thread docs/toolhive/guides-k8s/index.mdx Outdated
Reword the Registry Server paragraph in the K8s operator intro to
make it clear that MCPRegistry is a separate capability, not a 4th
MCP server resource type.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Copy link
Copy Markdown
Collaborator

@danbarr danbarr left a comment

Choose a reason for hiding this comment

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

Thank you!

@rdimitrov rdimitrov merged commit 383db72 into main Apr 13, 2026
4 checks passed
@rdimitrov rdimitrov deleted the add-registry-server-crossrefs branch April 13, 2026 23:29
@rdimitrov rdimitrov self-assigned this Apr 14, 2026
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.

[Enhancement]: Add cross-references to Registry Server from existing documentation

3 participants