doc: restructure sidebar by user journey

- dissolve "Post Installation": Import, Integrations and Configuration become their own goal-based categories again
- Docker becomes a linked category holding its reverse proxy guides andimage verification
- tokens page moves into Installation (required before first sign-in), labeled "Generating Tokens"
- FAQ and screenshots move back up behind Installation
- upgrading_postgres before manually_fixing_data (frequency order)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Author: JakobLichterfeld

CHANGELOG.md

@@ -29,6 +29,7 @@
 
 - doc: improve token and upgrade documentation, restructure sidebar (#5628 - @brianmay)
 - doc: promote token security note to warning admonition in docker/nixos install (#5628 - @JakobLichterfeld)
+- doc: restructure sidebar by user journey (#5642 - @JakobLichterfeld)
 
 ## [4.1.1] - 2026-08-14
 

website/docs/installation/tokens.md

@@ -1,6 +1,6 @@
 ---
 title: Generating Tokens
-sidebar_label: Tokens
+sidebar_label: Generating Tokens
 ---
 
 ## Types of tokens

website/sidebars.js

@@ -4,18 +4,25 @@ module.exports = {
       type: "category",
       label: "Installation",
       items: [
-        "installation/docker",
-        "installation/nixos",
-        "advanced_guides/verifying_images",
         {
           type: "category",
-          label: "Reverse Proxy",
+          label: "Docker",
+          link: { type: "doc", id: "installation/docker" },
           items: [
-            "advanced_guides/traefik",
-            "advanced_guides/apache",
-            "advanced_guides/unix_domain_sockets",
+            {
+              type: "category",
+              label: "Reverse Proxy",
+              items: [
+                "advanced_guides/traefik",
+                "advanced_guides/apache",
+                "advanced_guides/unix_domain_sockets",
+              ],
+            },
+            "advanced_guides/verifying_images",
           ],
         },
+        "installation/nixos",
+        "installation/tokens",
         {
           type: "category",
           label: "Unsupported methods",
@@ -27,33 +34,38 @@ module.exports = {
         },
       ],
     },
+    "faq",
+    "screenshots",
+    {
+      type: "category",
+      label: "Configuration",
+      items: ["configuration/environment_variables", "configuration/api"],
+    },
     {
       type: "category",
-      label: "Post Installation",
+      label: "Import",
+      items: ["import/teslafi", "import/tesla_apiscraper"],
+    },
+    {
+      type: "category",
+      label: "Integrations",
       items: [
-        "installation/tokens",
-        "import/teslafi",
-        "import/tesla_apiscraper",
         "integrations/home_assistant",
         "integrations/mqtt",
         "integrations/Node-RED",
       ],
     },
-    "configuration/environment_variables",
-    "configuration/api",
     {
       type: "category",
       label: "Maintenance",
       items: [
         "upgrading",
         "maintenance/backup",
         "maintenance/restore",
-        "maintenance/manually_fixing_data",
         "maintenance/upgrading_postgres",
+        "maintenance/manually_fixing_data",
       ],
     },
-    "faq",
-    "screenshots",
     {
       type: "doc",
       id: "projects",