Merge pull request #816 from DuendeSoftware/ka/identity-server-categories

khalidabuhakmeh · web-flow · commit 843e3fbe2cb1 · 2025-07-09T08:54:01.000-04:00
Restructure IdentityServer documentation
diff --git a/README.md b/README.md
@@ -59,7 +59,7 @@ WebStorm has Grazie as a built-in spell checker and grammar checker, and support
 
 * Always prefer linking internally over linking externally. For example, when you talk about data protection, prefer an internal link over a link to external sites.
 * When linking to external content, consider writing one or two sentences about the context and what the reader will learn on the linked page.
-* When linking other pages, use a path that starts at the content root, like `/identityserver/troubleshooting.md`. Use the `.md(x)` file extension - Starlight will update the link to the correct format on build.
+* When linking other pages, use a path that starts at the content root, like `/identityserver/troubleshooting/index.md`. Use the `.md(x)` file extension - Starlight will update the link to the correct format on build.
 * When linking to external resources, use the full URL using HTTPS.
 * You can link to header anchors using the `#` symbol, for example `[multiple authentication methods](/identityserver/ui/federation.md#multiple-authentication-methods-for-users)`.
 * Link relevant text. Prefer `learn more about [improving the sign-in experience]` over `click [here] to learn more`.
diff --git a/src/content/docs/identitymodel-oidcclient/advanced/dpop.mdx b/src/content/docs/identitymodel-oidcclient/advanced/dpop.mdx
@@ -41,7 +41,7 @@ Console.WriteLine(jwk);
 :::caution
 In a production scenario, you'll want to store this JWK in a secure location
 and use ASP.NET's [data protection](https://docs.microsoft.com/en-us/aspnet/core/security/data-protection/) to further
-protect the JWK. See [our data protection guide](/identityserver/deployment#aspnet-core-data-protection) for more
+protect the JWK. See [our data protection guide](/identityserver/deployment/index.md#aspnet-core-data-protection) for more
 information.
 :::
 
diff --git a/src/content/docs/identityserver/aspnet-identity/_meta.yml b/src/content/docs/identityserver/aspnet-identity/_meta.yml
@@ -0,0 +1,3 @@
+label: "ASP.NET Identity Integration"
+collapsed: true
+order: 9
diff --git a/src/content/docs/identityserver/aspnet-identity/index.md b/src/content/docs/identityserver/aspnet-identity/index.md
@@ -2,7 +2,7 @@
 title: ASP.NET Identity Integration
 description: Guide to integrating ASP.NET Identity with IdentityServer for user management, including setup instructions and configuration options
 sidebar:
-  order: 9
+  label: Overview
 redirect_from:
   - /identityserver/v5/aspnet_identity/
   - /identityserver/v6/aspnet_identity/
diff --git a/src/content/docs/identityserver/deployment/_meta.yml b/src/content/docs/identityserver/deployment/_meta.yml
@@ -0,0 +1,3 @@
+label: "Deployment"
+collapsed: true
+order: 10
diff --git a/src/content/docs/identityserver/deployment/index.md b/src/content/docs/identityserver/deployment/index.md
@@ -3,7 +3,7 @@ title: IdentityServer Deployment
 description: Comprehensive guide covering key aspects of deploying IdentityServer including proxy configuration, data protection, data stores, caching, and health monitoring.
 date: 2020-09-10T08:20:20+02:00
 sidebar:
-  label: Deployment
+  label: Overview
   order: 10
 redirect_from:
    - /dataprotection/
diff --git a/src/content/docs/identityserver/diagnostics/data.mdx b/src/content/docs/identityserver/diagnostics/data.mdx
@@ -38,7 +38,7 @@ The diagnostics data contains the following information:
 * Registered non-default implementations of Duende IdentityServer extension points
   * Extension point type, implementation type, assembly name and version
 * [`IdentityServerOptions`](/identityserver/reference/options.md) configuration
-* [Data Protection](/identityserver/deployment.md#aspnet-core-data-protection) configuration
+* [Data Protection](/identityserver/deployment/index.md#aspnet-core-data-protection) configuration
   * `ApplicationDiscriminator`, `XmlEncryptor` and `XmlRepository`
 * Basic server information
   * Host name
diff --git a/src/content/docs/identityserver/fundamentals/key-management.md b/src/content/docs/identityserver/fundamentals/key-management.md
@@ -123,7 +123,7 @@ example, if you implement the `ISigningKeyStore` to store your keys in Azure Key
 Vault, you could safely disabled `DataProtectKeys`, relying on Azure Key Vault
 to encrypt your signing keys at rest.
 
-See the [deployment](/identityserver/deployment) section for more information
+See the [deployment](/identityserver/deployment/index.md) section for more information
 about setting up data protection.
 
 ### Manage Multiple Keys
diff --git a/src/content/docs/identityserver/fundamentals/users.md b/src/content/docs/identityserver/fundamentals/users.md
@@ -22,7 +22,7 @@ the security protocol (OpenID Connect and OAuth).
 
 :::note
 While you can use any custom user database or identity management library for your users, we
-provide [integration support](/identityserver/aspnet-identity/) for ASP.NET Identity.
+provide [integration support](/identityserver/aspnet-identity/index.md) for ASP.NET Identity.
 :::
 
 ## Authorization Endpoint And Login Page Workflow
diff --git a/src/content/docs/identityserver/overview/packaging.mdx b/src/content/docs/identityserver/overview/packaging.mdx
@@ -239,5 +239,5 @@ The **Duende IdentityServer with ASP.NET Core Identity** template integrates wit
 provide you with an instance of Duende IdentityServer that has a user store powered by the Microsoft
 library.
 
-[Please read our ASP.NET Identity documentation](/identityserver/aspnet-identity/), to learn more about this integration.
+[Please read our ASP.NET Identity documentation](/identityserver/aspnet-identity/index.md), to learn more about this integration.
 
diff --git a/src/content/docs/identityserver/troubleshooting/_meta.yml b/src/content/docs/identityserver/troubleshooting/_meta.yml
@@ -0,0 +1,3 @@
+label: "Troubleshooting"
+collapsed: true
+order: 15
diff --git a/src/content/docs/identityserver/troubleshooting/index.mdx b/src/content/docs/identityserver/troubleshooting/index.mdx
@@ -1,7 +1,7 @@
 ---
 title: Duende IdentityServer Troubleshooting
 sidebar:
-  label: Troubleshooting
+  label: Overview
   order: 15
 redirect_from:
   - /mim/
@@ -53,7 +53,7 @@ Core Authentication libraries. If it is not correctly configured it might result
 - The key `{xxxxx-xxxx-xxx-xxx-xxxxxxx}` was not found in the key ring.
 - Failed to unprotect AuthenticationTicket payload for key `{key}`
 
-See [our data protection guide](/identityserver/deployment#aspnet-core-data-protection) for more
+See [our data protection guide](/identityserver/deployment/index.md#aspnet-core-data-protection) for more
 information.
 
 ## Load Balancing, proxies and TLS offloading
@@ -66,7 +66,7 @@ To diagnose, open the discovery document (append `/.well-known/openid-configurat
 e.g. https://demo.duendesoftware.com/.well-known/openid-configuration. Make sure that the URLs listed in there have the
 correct host name and are listed as https (assuming you are running under https, which you should).
 
-See [our proxy guide](/identityserver/deployment#proxy-servers-and-load-balancers) for more information.
+See [our proxy guide](/identityserver/deployment/index.md#proxy-servers-and-load-balancers) for more information.
 
 ## TaskCancellationExceptions
 
diff --git a/src/content/docs/identityserver/ui/login/external.md b/src/content/docs/identityserver/ui/login/external.md
@@ -195,7 +195,7 @@ builder.Services.AddAuthentication()
     });
 ```
 
-Learn more about [ASP.NET Identity and its relationship to Duende IdentityServer](/identityserver/aspnet-identity/).
+Learn more about [ASP.NET Identity and its relationship to Duende IdentityServer](/identityserver/aspnet-identity/index.md).
 
 ## Handling The Callback
 
diff --git a/src/content/docs/identityserver/ui/login/local.md b/src/content/docs/identityserver/ui/login/local.md
@@ -94,5 +94,5 @@ path: ~/Pages/Account/Login.cshtml, which allows it to be loaded from the
 browser at the "/Account/Login" path. 
 
 :::note
-While you can use any custom user database or identity management library for your users, we provide first class [integration support](/identityserver/aspnet-identity/) for ASP.NET Identity.
+While you can use any custom user database or identity management library for your users, we provide first class [integration support](/identityserver/aspnet-identity/index.md) for ASP.NET Identity.
 :::
diff --git a/src/content/docs/identityserver/upgrades/identityserver4-to-duende-identityserver-v7.mdx b/src/content/docs/identityserver/upgrades/identityserver4-to-duende-identityserver-v7.mdx
@@ -460,7 +460,7 @@ When upgrading, consider how those applications will handle an upgraded token se
 
 ### Step 7: Verify Data Protection Configuration :badge[Optional]
 
-Duende IdentityServer depends on [ASP.NET Data Protection](/identityserver/deployment.md#aspnet-core-data-protection) to encrypt and sign data using keys managed by ASP.NET.
+Duende IdentityServer depends on [ASP.NET Data Protection](/identityserver/deployment/index.md#aspnet-core-data-protection) to encrypt and sign data using keys managed by ASP.NET.
 
 As part of your migration, verify the application name is set in your Data Protection configuration:
 

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	`+label: "ASP.NET Identity Integration"`
	`2`	`+collapsed: true`
	`3`	`+order: 9`
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	`+label: "Deployment"`
	`2`	`+collapsed: true`
	`3`	`+order: 10`