Tweak the documentation routes and revamp the menus

configuration/index.md

@@ -0,0 +1,20 @@
+# Configuration and settings
+
+<div class="row">
+    <div class="col-md-4">
+        <div class="panel panel-default" style="min-height: 120px;">
+            <div class="panel-body">
+                <p><strong><a href="application-permissions.md">Application permissions</a></strong></p>
+                <p>Learn how to leverage permissions to control the OIDC features a client is allowed to use.</p>
+            </div>
+        </div>
+    </div>
+    <div class="col-md-4">
+        <div class="panel panel-default" style="min-height: 120px;">
+            <div class="panel-body">
+                <p><strong><a href="token-setup-and-validation.md">Token setup and API validation</a></strong></p>
+                <p>Learn how to change the default token format and register the API token validation components.</p>
+            </div>
+        </div>
+    </div>
+</div>

configuration/toc.yml

@@ -0,0 +1,8 @@
+- name: Introduction
+  href: index.md
+
+- name: Token setup and API validation
+  href: token-setup-and-validation.md
+
+- name: Application permissions
+  href: application-permissions.md

docs/toc.yml

@@ -1,18 +0,0 @@
-- name: Guides
-  items:
-    - name: Introduction
-      href: guide/index.md
-    - name: Getting started
-      href: guide/getting-started.md
-    - name: Samples
-      href: guide/samples.md
-    - name: Migration guide
-      href: guide/migration.md
-    - name: Understanding the different token formats
-      href: guide/token-formats.md
-- name: Configuration
-  items:
-    - name: Token setup and API validation
-      href: configuration/token-setup-and-validation.md
-    - name: Application permissions
-      href: configuration/application-permissions.md

guide/toc.yml

@@ -0,0 +1,14 @@
+- name: Introduction
+  href: index.md
+
+- name: Getting started
+  href: getting-started.md
+
+- name: Samples
+  href: samples.md
+
+- name: Migration guide
+  href: migration.md
+
+- name: Understanding the different token formats
+  href: token-formats.md

index.md

@@ -6,7 +6,7 @@ OpenIddict aims at providing a **simple and easy-to-use solution** to implement
     <div class="col-md-4">
         <div class="panel panel-default" style="min-height: 120px;">
             <div class="panel-body">
-                <p><strong><a href="docs/guide/index.md">Introduction</a></strong></p>
+                <p><strong><a href="guide/index.md">Introduction</a></strong></p>
                 <p>Read an introduction on OpenIddict and the reason it was created.</p>
             </div>
         </div>
@@ -14,7 +14,7 @@ OpenIddict aims at providing a **simple and easy-to-use solution** to implement
     <div class="col-md-4">
         <div class="panel panel-default" style="min-height: 120px;">
             <div class="panel-body">
-                <p><strong><a href="docs/guide/getting-started.md">Getting started</a></strong></p>
+                <p><strong><a href="guide/getting-started.md">Getting started</a></strong></p>
                 <p>Get started quickly by working through this step-by-step guide.</p>
             </div>
         </div>
@@ -22,7 +22,7 @@ OpenIddict aims at providing a **simple and easy-to-use solution** to implement
     <div class="col-md-4">
         <div class="panel panel-default" style="min-height: 120px;">
             <div class="panel-body">
-                <p><strong><a href="docs/guide/samples.md">Samples</a></strong></p>
+                <p><strong><a href="guide/samples.md">Samples</a></strong></p>
                 <p>View samples implementing the various authorization flows.</p>
             </div>
         </div>

toc.yml

@@ -1,2 +1,5 @@
-- name: User guide
-  href: docs/
+- name: User guides
+  href: guide/index.md
+
+- name: Configuration and settings
+  href: configuration/index.md