feat: update navigation (#350)

* feat: update navigation

* spelling fixes

* another spelling fix

* fixing broken internal links

* setup and install -> quickstart

* better name

* fixing bad links

Author: tomarra

.github/cspell.json

@@ -25,7 +25,8 @@
     "boltman",
     "bryanoltman",
     "buildroot",
-    "Classpath",
+    "canva",
+    "classpath",
     "codemagic",
     "codepush",
     "codesign",
@@ -41,7 +42,7 @@
     "prefs",
     "previewable",
     "rollouts",
-    "SDKMAN",
+    "sdkman",
     "shorebirdtech",
     "temurin",
     "xcarchive",

astro.config.mjs

@@ -52,110 +52,33 @@ export default defineConfig({
       },
       sidebar: [
         {
-          label: 'Getting Started',
+          label: 'Welcome',
           link: '/',
         },
         {
-          label: 'Code Push',
-          autogenerate: {
-            directory: 'code-push',
-          },
-        },
-        {
-          label: 'Guides',
-          items: [
-            {
-              label: 'Development Workflow',
-              link: '/guides/development-workflow',
-            },
-            {
-              label: 'Staging Patches',
-              link: '/guides/staging-patches',
-            },
-            {
-              label: 'Testing Patches',
-              link: '/guides/testing-patches',
-            },
-            {
-              label: 'Signing Patches',
-              link: '/guides/patch-signing',
-            },
-            {
-              label: 'Percentage-Based Rollouts',
-              link: '/guides/percentage-based-rollouts',
-            },
-            {
-              label: 'Crash Reporting',
-              link: '/guides/crash-reporting',
-            },
-            {
-              label: 'Flavors',
-              autogenerate: {
-                directory: 'guides/flavors',
-              },
-            },
-            {
-              label: 'Submitting to Stores',
-              autogenerate: {
-                directory: 'guides/submitting',
-              },
-            },
-            {
-              label: 'Hybrid Apps',
-              autogenerate: {
-                directory: 'guides/hybrid-apps',
-              },
-            },
-          ],
-        },
-        {
-          label: 'Continuous Integration',
-          autogenerate: {
-            directory: 'ci',
-          },
-        },
-        {
-          label: 'Crash Reporting',
-          autogenerate: {
-            directory: 'guides/crash-reporting',
-          },
+          label: 'Getting Started',
+          collapsed: true,
+          autogenerate: { directory: 'Getting Started' },
         },
         {
-          label: 'Flutter Version',
-          link: '/flutter-version',
+          label: 'Code Push',
+          collapsed: true,
+          autogenerate: { directory: 'Code Push' },
         },
         {
-          label: 'Organizations',
-          link: '/orgs',
+          label: 'Shorebird Account',
+          collapsed: true,
+          autogenerate: { directory: 'Shorebird Account' },
         },
         {
-          label: 'Update Strategies',
-          link: '/update-strategies',
+          label: 'Shorebird System',
+          collapsed: true,
+          autogenerate: { directory: 'Shorebird System' },
         },
         {
-          label: 'FAQ',
+          label: 'FAQ & Troubleshooting',
           link: '/faq',
         },
-        {
-          label: 'Status',
-          link: '/status',
-        },
-        {
-          label: 'Billing',
-          link: '/billing',
-        },
-        {
-          label: 'Architecture',
-          link: '/architecture',
-        },
-        {
-          label: 'Uninstall',
-          link: '/uninstall',
-        },
-        {
-          label: 'Troubleshooting',
-          link: '/troubleshooting',
-        },
       ],
       plugins: [
         starlightLinksValidator({

src/content/docs/ci/_authentication.mdx …ntinuous Integration/_authentication.mdxsrc/content/docs/ci/_authentication.mdx renamed to src/content/docs/Code Push/Continuous Integration/_authentication.mdx src/content/docs/ci/_authentication.mdx renamed to src/content/docs/Code Push/Continuous Integration/_authentication.mdx

@@ -3,7 +3,7 @@ title: Codemagic Integration
 description: Integrate Shorebird into your Codemagic workflow
 sidebar:
   label: Codemagic
-  order: 2
+  order: 9
 ---
 
 {/* cspell:words Codemagic astrojs proto tlsv maclinux elif getenv codesigning testflight */}

src/content/docs/ci/codemagic.mdx …ush/Continuous Integration/codemagic.mdxsrc/content/docs/ci/codemagic.mdx renamed to src/content/docs/Code Push/Continuous Integration/codemagic.mdx src/content/docs/ci/codemagic.mdx renamed to src/content/docs/Code Push/Continuous Integration/codemagic.mdx

@@ -1,6 +1,8 @@
 ---
 title: Fastlane
 description: Using fastlane with Shorebird
+sidebar:
+  order: 10
 ---
 
 {/* cspell:words Fastfile testflight */}
@@ -19,7 +21,8 @@ Follow the setup instructions on the fastlane website to install fastlane
 
 This guide assumes that you have shorebird installed on the machine that will be
 running the fastlane commands. If you have not already installed shorebird, you
-can do so by following the [Getting Started instructions](/#install).
+can do so by following the
+[Getting Started instructions](/getting-started/quick-start).
 
 If you are not already using fastlane with your project, navigate to your app's
 `ios` directory in your project and run `fastlane init`. You will be prompted to
@@ -52,10 +55,15 @@ To run this, execute the following command:
 bundle exec fastlane release_shorebird
 ```
 
-:::note To upload to TestFlight, you will need to create an Apple app-specific
-password. You can do this at https://appleid.apple.com/account/manage. Once you
-have created the password, create a `.env` file in your fastlane directory and
-add `FASTLANE_APPLE_APPLICATION_SPECIFIC_PASSWORD=your_password_here`. :::
+{/* prettier-ignore */}
+:::note
+
+To upload to TestFlight, you will need to create an Apple app-specific password.
+You can do this at https://appleid.apple.com/account/manage. Once you have
+created the password, create a `.env` file in your fastlane directory and add
+`FASTLANE_APPLE_APPLICATION_SPECIFIC_PASSWORD=your_password_here`.
+
+:::
 
 If you would like to provide additional arguments to the release command, you
 can do so using the `args` parameter. For example:

src/content/docs/ci/fastlane.mdx …Push/Continuous Integration/fastlane.mdxsrc/content/docs/ci/fastlane.mdx renamed to src/content/docs/Code Push/Continuous Integration/fastlane.mdx src/content/docs/ci/fastlane.mdx renamed to src/content/docs/Code Push/Continuous Integration/fastlane.mdx

@@ -3,7 +3,7 @@ title: CI Integration
 description: Integrate Shorebird in CI
 sidebar:
   label: Generic
-  order: 3
+  order: 11
 ---
 
 {/* cspell:words proto tlsv codemagic */}
@@ -18,8 +18,8 @@ Flutter CI builds. Changes required:
 
 We have detailed instructions for integrating into
 
-- [GitHub](/ci/github)
-- [Codemagic](/ci/codemagic)
+- [GitHub](/code-push/continuous-integration/github)
+- [Codemagic](/code-push/continuous-integration/codemagic)
 
 However if you do not use these providers, we've also provided generic
 instructions below:

src/content/docs/ci/generic.mdx … Push/Continuous Integration/generic.mdxsrc/content/docs/ci/generic.mdx renamed to src/content/docs/Code Push/Continuous Integration/generic.mdx src/content/docs/ci/generic.mdx renamed to src/content/docs/Code Push/Continuous Integration/generic.mdx

@@ -3,7 +3,7 @@ title: GitHub Integration
 description: Integrate Shorebird into your GitHub workflow
 sidebar:
   label: GitHub
-  order: 1
+  order: 8
 ---
 
 {/* cspell:words shorebirdtech */}
@@ -19,7 +19,12 @@ Action allows you to integrate Shorebird into your existing GitHub Workflows.
 
 ✅ You are logged into a Shorebird account.
 
-:::note Refer to the [getting started](/) instructions for more information. :::
+{/* prettier-ignore */}
+:::note
+
+Refer to the [getting started](/) instructions for more information.
+
+:::
 
 ## Quick Start
 
@@ -56,8 +61,13 @@ In the above workflow, we're using the `setup-shorebird` action to configure
 Shorebird in our CI and in subsequent steps we can execute any Shorebird
 commands.
 
-:::note Currently `setup-shorebird` only supports the latest stable version of
-shorebird. :::
+{/* prettier-ignore */}
+:::note
+
+Currently `setup-shorebird` only supports the latest stable version of
+shorebird.
+
+:::
 
 ## Authentication
 
@@ -197,4 +207,4 @@ jobs:
 :::
 
 For an example of a fully automated development workflow, see our
-[Development Workflow Guide](/guides/development-workflow).
+[Development Workflow Guide](/code-push/guides/development-workflow).

src/content/docs/ci/github.mdx …e Push/Continuous Integration/github.mdxsrc/content/docs/ci/github.mdx renamed to src/content/docs/Code Push/Continuous Integration/github.mdx src/content/docs/ci/github.mdx renamed to src/content/docs/Code Push/Continuous Integration/github.mdx

@@ -3,7 +3,7 @@ title: Crashlytics Integration
 description: Integrate Shorebird into your Crashlytics crash reporting
 sidebar:
   label: Crashlytics
-  order: 2
+  order: 14
 ---
 
 If you're using Crashlytics for crash reporting, it will work out-of-the-box

…h-reporting/Integrations/crashlytics.mdx …ode Push/Crash Reporting/crashlytics.mdxsrc/content/docs/guides/crash-reporting/Integrations/crashlytics.mdx renamed to src/content/docs/Code Push/Crash Reporting/crashlytics.mdx src/content/docs/guides/crash-reporting/Integrations/crashlytics.mdx renamed to src/content/docs/Code Push/Crash Reporting/crashlytics.mdx

@@ -3,7 +3,7 @@ title: Sentry Integration
 description: Integrate Shorebird into your Sentry crash reporting
 sidebar:
   label: Sentry
-  order: 1
+  order: 13
 ---
 
 If you're using Sentry for crash reporting, it will work out-of-the-box with

…/crash-reporting/Integrations/sentry.mdx …ocs/Code Push/Crash Reporting/sentry.mdxsrc/content/docs/guides/crash-reporting/Integrations/sentry.mdx renamed to src/content/docs/Code Push/Crash Reporting/sentry.mdx src/content/docs/guides/crash-reporting/Integrations/sentry.mdx renamed to src/content/docs/Code Push/Crash Reporting/sentry.mdx

@@ -1,6 +1,8 @@
 ---
 title: Uploading Symbols
 description: Locating and uploading symbols for crash reporting
+sidebar:
+  order: 12
 ---
 
 Shorebird uses a fork of Flutter to build your app. This means we've built our