Merge pull request #151 from eshtek/feature/guide-links

Restructures troubleshooting guide navigation

Author: jerodfritz

docs/.vitepress/sidebar.ts

@@ -65,9 +65,17 @@ const sidebar: DefaultTheme.SidebarItem[] = [
     collapsed: true,
     items: [
       { text: 'Overview', link: '/troubleshooting/' },
-      { text: 'Avoid USB Drives', link: '/troubleshooting/common-issues/AvoidUSBDrives' },
-      { text: 'Clear Browser Cache', link: '/troubleshooting/common-issues/ClearCache' },
-      { text: 'Immich Migration', link: '/troubleshooting/common-issues/ImmichMigration' },
+      {
+        text: 'Common Issues',
+        link: '/troubleshooting/common-issues/',
+        collapsed: true,
+        items: [
+          { text: 'Application Errors', link: '/troubleshooting/common-issues/ApplicationErrors' },
+          { text: 'Avoid USB Drives', link: '/troubleshooting/common-issues/AvoidUSBDrives' },
+          { text: 'Clear Browser Cache', link: '/troubleshooting/common-issues/ClearCache' },
+          { text: 'Immich Migration', link: '/troubleshooting/common-issues/ImmichMigration' },
+        ]
+      },
     ]
   },
   {

docs/troubleshooting/common-issues/ApplicationErrors.md

@@ -122,7 +122,7 @@ Uploads: (HDDs/SSDs)/Photos/immich <br>
 Postgres: (HDDs/SSDs)/Applications/immich/postgres_data <br>
 
 
-If your storage locations do not match and you installed Immich via HexOS, are on Immich version 2.0.0+ and have not modified Immich in TrueNAS then you can `Reset App Curation`
+If your storage locations do not match and you installed Immich via HexOS, are on Immich version 2.0.0+ and have not modified Immich in TrueNAS then you can [`Reset App Curation`](/troubleshooting/common-issues/ApplicationErrors.html#resetting-app-curation)
 
 :::
 # What to do if you need more help with apps

docs/troubleshooting/common-issues/index.md

@@ -2,8 +2,10 @@
 
 Having trouble with your HexOS setup? Check out these common issues and solutions from the community.
 
+- [**Application Errors**](./ApplicationErrors) - Troubleshooting app installation, updates, and startup issues
 - [**Avoid USB Drives**](./AvoidUSBDrives) - Why USB drives can cause issues and what to use instead
 - [**Clear Browser Cache**](./ClearCache) - Fix login issues and UI problems by clearing your browser cache
+- [**Immich Migration**](./ImmichMigration) - Guide for migrating existing Immich installations to HexOS
 
 :::tip Contribute to Documentation
 Found a solution that worked? [Learn how to contribute](/community/how-to-contribute/) to improve these docs for everyone, submit corrections through the documentation repository, or share your solutions on the [HexOS Community forum](https://hub.hexos.com/).

docs/troubleshooting/index.md

@@ -3,7 +3,13 @@
 This guide helps you resolve common issues with HexOS installation, setup, and operation. Issues are organized by category for quick reference.
 
 :::tip Quick Help
-Check our [Common Issues](./common-issues/) section or visit the [HexOS Community](https://hub.hexos.com/) for posts by other users.
+Check our [Common Issues](./common-issues/) section for frequently encountered problems:
+- [Application Errors](./common-issues/ApplicationErrors) - App installation, updates, and startup issues
+- [Immich Migration Guide](./common-issues/ImmichMigration) - Migrating existing Immich installations
+- [Clear Browser Cache](./common-issues/ClearCache) - Fixing login and UI issues
+- [Avoid USB Drives](./common-issues/AvoidUSBDrives) - Why USB drives cause problems
+
+Visit the [HexOS Community](https://hub.hexos.com/) for additional support from other users.
 :::
 
 ## Installation Issues