Rename files to mdx, fix up admonition syntax

danbarr · jhrozek · commit ffd5eda66020 · 2025-10-29T12:21:57.000Z
Signed-off-by: Dan Barr &lt;6922515+danbarr@users.noreply.github.com&gt;
diff --git a/docs/toolhive/_partials/_auth-troubleshooting.mdx b/docs/toolhive/_partials/_auth-troubleshooting.mdx
diff --git a/docs/toolhive/_partials/_basic-cedar-config.mdx b/docs/toolhive/_partials/_basic-cedar-config.mdx
@@ -27,6 +27,6 @@ ownership or sensitivity labels.
 :::tip
 
 For more policy examples and advanced usage, see
-[Cedar policies](../concepts/cedar-policies.md).
+[Cedar policies](../concepts/cedar-policies.mdx).
 
 :::
diff --git a/docs/toolhive/_partials/_oidc-prerequisites.mdx b/docs/toolhive/_partials/_oidc-prerequisites.mdx
@@ -19,4 +19,4 @@ service account tokens (for example, in Kubernetes). ToolHive never sees your
 password, only signed tokens from your identity provider.
 
 For background on authentication, authorization, and Cedar policy examples, see
-[Authentication and authorization framework](../concepts/auth-framework.md).
+[Authentication and authorization framework](../concepts/auth-framework.mdx).
diff --git a/docs/toolhive/concepts/auth-framework.mdx b/docs/toolhive/concepts/auth-framework.mdx
@@ -254,4 +254,4 @@ requirements.
 ## Related information
 
 - For detailed policy writing guidance, see
-  [Cedar policies](./cedar-policies.md)
+  [Cedar policies](./cedar-policies.mdx)
diff --git a/docs/toolhive/concepts/cedar-policies.mdx b/docs/toolhive/concepts/cedar-policies.mdx
@@ -11,7 +11,7 @@ policies, configure authorization settings, and troubleshoot common issues.
 :::info
 
 For the conceptual overview of authentication and authorization, see
-[Authentication and authorization framework](./auth-framework.md).
+[Authentication and authorization framework](./auth-framework.mdx).
 
 :::
 
@@ -403,6 +403,6 @@ When policies don't work as expected, follow this systematic approach:
 ## Related information
 
 - For the conceptual overview, see
-  [Authentication and authorization framework](./auth-framework.md)
+  [Authentication and authorization framework](./auth-framework.mdx)
 - For detailed Cedar policy syntax, see
   [Cedar documentation](https://docs.cedarpolicy.com/)
diff --git a/docs/toolhive/guides-cli/auth.mdx b/docs/toolhive/guides-cli/auth.mdx
@@ -5,9 +5,9 @@ description:
   ToolHive CLI.
 ---
 
-import OidcPrerequisites from '../_partials/_oidc-prerequisites.md';
-import BasicCedarConfig from '../_partials/_basic-cedar-config.md';
-import AuthTroubleshooting from '../_partials/_auth-troubleshooting.md';
+import OidcPrerequisites from '../_partials/_oidc-prerequisites.mdx';
+import BasicCedarConfig from '../_partials/_basic-cedar-config.mdx';
+import AuthTroubleshooting from '../_partials/_auth-troubleshooting.mdx';
 
 This guide shows you how to secure your MCP servers using OAuth-based
 authentication and Cedar-based authorization policies with the ToolHive CLI.
@@ -63,7 +63,7 @@ The token should:
 - Not be expired
 - Have a valid signature
 
-:::note Client support limitations
+:::note[Client support limitations]
 
 Client support for authentication is limited at this time. While some clients
 support HTTP headers with SSE MCP client configurations, we do not recommend
@@ -75,7 +75,7 @@ for clients. Stay tuned for updates on this feature.
 
 :::
 
-:::note Obtaining JWT tokens
+:::note[Obtaining JWT tokens]
 
 How to obtain JWT tokens varies by identity provider and is outside the scope of
 this guide. Consult your identity provider's documentation for specific
@@ -158,7 +158,7 @@ If you're having issues with the CLI:
 ## Related information
 
 - For conceptual understanding, see
-  [Authentication and authorization framework](../concepts/auth-framework.md)
+  [Authentication and authorization framework](../concepts/auth-framework.mdx)
 - For detailed Cedar policy syntax, see
-  [Cedar policies](../concepts/cedar-policies.md) and the
+  [Cedar policies](../concepts/cedar-policies.mdx) and the
   [Cedar documentation](https://docs.cedarpolicy.com/)
diff --git a/docs/toolhive/guides-k8s/auth-k8s.mdx b/docs/toolhive/guides-k8s/auth-k8s.mdx
@@ -5,9 +5,9 @@ description:
   using the ToolHive Operator.
 ---
 
-import OidcPrerequisites from '../_partials/_oidc-prerequisites.md';
-import BasicCedarConfig from '../_partials/_basic-cedar-config.md';
-import AuthTroubleshooting from '../_partials/_auth-troubleshooting.md';
+import OidcPrerequisites from '../_partials/_oidc-prerequisites.mdx';
+import BasicCedarConfig from '../_partials/_basic-cedar-config.mdx';
+import AuthTroubleshooting from '../_partials/_auth-troubleshooting.mdx';
 
 This guide shows you how to secure your MCP servers in Kubernetes using
 authentication and authorization with the ToolHive Operator.
@@ -28,7 +28,7 @@ You'll need:
 
 - Kubernetes cluster with RBAC enabled
 - ToolHive Operator installed (see
-  [Deploy the ToolHive Operator with Helm](./deploy-operator-helm.md))
+  [Deploy the ToolHive Operator with Helm](./deploy-operator-helm.mdx))
 - `kubectl` access to your cluster
 
 ## Choose your authentication approach
@@ -370,11 +370,11 @@ kubectl logs -n toolhive-system -l app.kubernetes.io/name=weather-server-k8s
 ## Related information
 
 - For conceptual understanding, see
-  [Authentication and authorization framework](../concepts/auth-framework.md)
+  [Authentication and authorization framework](../concepts/auth-framework.mdx)
 - For detailed Cedar policy syntax, see
-  [Cedar policies](../concepts/cedar-policies.md) and the
+  [Cedar policies](../concepts/cedar-policies.mdx) and the
   [Cedar documentation](https://docs.cedarpolicy.com/)
 - For running MCP servers without authentication, see
   [Run MCP servers in Kubernetes](./run-mcp-k8s.mdx)
 - For ToolHive Operator installation, see
-  [Deploy the ToolHive Operator with Helm](./deploy-operator-helm.md)
+  [Deploy the ToolHive Operator with Helm](./deploy-operator-helm.mdx)
