diff --git a/docs/getting-started/installation.md b/docs/getting-started/installation.md
index 4246799..5967a9f 100644
--- a/docs/getting-started/installation.md
+++ b/docs/getting-started/installation.md
@@ -87,5 +87,5 @@ Profile storage, credential providers, and Global Discovery Service integration.
 ## Next Steps
 
 - [Configure authentication](/docs/guides/authentication) to connect to your environment
-- [Explore the CLI commands](/docs/reference/cli/overview)
-- [Learn the libraries](/docs/reference/libraries/overview)
+- [Explore the CLI commands](/docs/reference/cli)
+- [Learn the libraries](/docs/reference/libraries)
diff --git a/docs/guides/authentication.md b/docs/guides/authentication.md
index 588992b..88de26e 100644
--- a/docs/guides/authentication.md
+++ b/docs/guides/authentication.md
@@ -343,5 +343,5 @@ ppds auth create
 
 ## Next steps
 
-- [CLI Command Reference](/docs/reference/cli/overview)
-- [Libraries Overview](/docs/reference/libraries/overview)
+- [CLI Command Reference](/docs/reference/cli)
+- [Libraries Overview](/docs/reference/libraries)
diff --git a/docs/reference/cli/overview.md b/docs/reference/cli/index.md
similarity index 98%
rename from docs/reference/cli/overview.md
rename to docs/reference/cli/index.md
index 41b9c10..53e658a 100644
--- a/docs/reference/cli/overview.md
+++ b/docs/reference/cli/index.md
@@ -201,4 +201,4 @@ All four of the first variables must be set. Setting one to three of four is a h
 ## Next Steps
 
 - [Authentication](/docs/guides/authentication) — create profiles, service principal setup, federated auth
-- [Libraries Overview](/docs/reference/libraries/overview) — the libraries the CLI is built on
+- [Libraries Overview](/docs/reference/libraries) — the libraries the CLI is built on
diff --git a/docs/reference/libraries/Auth/_index.md b/docs/reference/libraries/Auth/api-reference.md
similarity index 100%
rename from docs/reference/libraries/Auth/_index.md
rename to docs/reference/libraries/Auth/api-reference.md
diff --git a/docs/reference/libraries/Dataverse/_index.md b/docs/reference/libraries/Dataverse/api-reference.md
similarity index 100%
rename from docs/reference/libraries/Dataverse/_index.md
rename to docs/reference/libraries/Dataverse/api-reference.md
diff --git a/docs/reference/libraries/Migration/_index.md b/docs/reference/libraries/Migration/api-reference.md
similarity index 100%
rename from docs/reference/libraries/Migration/_index.md
rename to docs/reference/libraries/Migration/api-reference.md
diff --git a/docs/reference/libraries/Plugins/_index.md b/docs/reference/libraries/Plugins/api-reference.md
similarity index 100%
rename from docs/reference/libraries/Plugins/_index.md
rename to docs/reference/libraries/Plugins/api-reference.md
diff --git a/docs/reference/libraries/overview.md b/docs/reference/libraries/index.md
similarity index 99%
rename from docs/reference/libraries/overview.md
rename to docs/reference/libraries/index.md
index 2c5278c..8103dd4 100644
--- a/docs/reference/libraries/overview.md
+++ b/docs/reference/libraries/index.md
@@ -255,4 +255,4 @@ Breaking changes are listed in each package's `CHANGELOG.md` in the main repo: [
 ## Next steps
 
 - [Authentication guide](/docs/guides/authentication) — profile creation and credential flows
-- [CLI reference](/docs/reference/cli/overview) — commands built on these libraries
+- [CLI reference](/docs/reference/cli) — commands built on these libraries
diff --git a/docs/reference/mcp/_index.md b/docs/reference/mcp/api-reference.md
similarity index 100%
rename from docs/reference/mcp/_index.md
rename to docs/reference/mcp/api-reference.md
diff --git a/docs/reference/mcp/overview.md b/docs/reference/mcp/index.md
similarity index 98%
rename from docs/reference/mcp/overview.md
rename to docs/reference/mcp/index.md
index 3ec9ce9..bf200a2 100644
--- a/docs/reference/mcp/overview.md
+++ b/docs/reference/mcp/index.md
@@ -133,5 +133,5 @@ Treat the MCP server the same way you treat an interactive CLI session: scope it
 
 - [Claude Code MCP docs](https://docs.claude.com/en/docs/claude-code/mcp) — host-side configuration and debugging
 - [modelcontextprotocol.io](https://modelcontextprotocol.io) — protocol specification
-- [PPDS CLI reference](/docs/reference/cli/overview) — same backend, command-line surface
+- [PPDS CLI reference](/docs/reference/cli) — same backend, command-line surface
 - [Authentication guide](/docs/guides/authentication) — create profiles for `--profile`
diff --git a/docusaurus.config.ts b/docusaurus.config.ts
index d5965b4..2533253 100644
--- a/docusaurus.config.ts
+++ b/docusaurus.config.ts
@@ -98,7 +98,7 @@ const config: Config = {
           items: [
             { label: 'Getting Started', to: '/docs/getting-started/installation' },
             { label: 'Guides', to: '/docs/guides/authentication' },
-            { label: 'CLI Reference', to: '/docs/reference/cli/overview' },
+            { label: 'CLI Reference', to: '/docs/reference/cli' },
           ],
         },
         {
diff --git a/sidebars.ts b/sidebars.ts
index 9d73a8d..7e345ff 100644
--- a/sidebars.ts
+++ b/sidebars.ts
@@ -21,19 +21,8 @@ const sidebars: SidebarsConfig = {
       label: 'Reference',
       items: [
         {
-          type: 'category',
-          label: 'CLI',
-          items: ['reference/cli/overview'],
-        },
-        {
-          type: 'category',
-          label: 'Libraries',
-          items: ['reference/libraries/overview'],
-        },
-        {
-          type: 'category',
-          label: 'MCP',
-          items: ['reference/mcp/overview'],
+          type: 'autogenerated',
+          dirName: 'reference',
         },
       ],
     },