Sidenav upkeep (#11302)

Partially contributes to
#11217, at least for the
current site design.

src/_data/sidenav.yml

@@ -1,4 +1,5 @@
 - header: Get started
+
 - title: Set up Flutter
   permalink: /get-started/install
 
@@ -17,7 +18,7 @@
           permalink: /get-started/fundamentals/dart
         - title: Widgets
           permalink: /get-started/fundamentals/widgets
-        - title: Layouts
+        - title: Layout
           permalink: /get-started/fundamentals/layout
         - title: State management
           permalink: /get-started/fundamentals/state-management
@@ -28,18 +29,6 @@
         - title: Local data and caching
           permalink: /get-started/fundamentals/local-caching
 
-    - title: Dart language
-      permalink: /resources/bootstrap-into-dart
-
-    - title: Codelabs & samples
-      children:
-        - title: Codelabs
-          permalink: /codelabs
-        - title: Cookbook
-          permalink: /cookbook
-        - title: Samples and demos
-          permalink: https://flutter.github.io/samples/
-
     - title: From another platform?
       permalink: /get-started/flutter-for
       children:
@@ -60,6 +49,14 @@
         - title: Flutter versus Swift concurrency
           permalink: /get-started/flutter-for/dart-swift-concurrency
 
+    - divider
+    - title: Codelabs
+      permalink: /codelabs
+    - title: Cookbook
+      permalink: /cookbook
+    - title: Demos and samples
+      permalink: https://flutter.github.io/samples/
+
 - title: Stay up to date
   permalink: /release
   children:
@@ -151,10 +148,10 @@
             permalink: https://pub.dev/packages/pay
     - title: Maps
       children:
-        - title: Add maps to your app
-          permalink: https://developers.google.com/maps/flutter-package
         - title: Add Google maps to a Flutter app
           permalink: https://codelabs.developers.google.com/codelabs/google-maps-in-flutter
+        - title: Google Maps package
+          permalink: https://developers.google.com/maps/flutter-package
     - title: News
       children:
         - title: Build a news app
@@ -165,7 +162,7 @@
 - title: Introduction
   permalink: /ui
 - title: Widget catalog
-  permalink: /ui/widgets      
+  permalink: /ui/widgets
 - title: Layout
   permalink: /ui/layout
   children:
@@ -248,7 +245,7 @@
       children:
         - title: Use custom fragment shaders
           permalink: /ui/design/graphics/fragment-shaders
-      
+
 - title: Interactivity
   permalink: /ui/interactivity
   children:
@@ -302,7 +299,7 @@
       permalink: /cookbook/images/fading-in-images
     - title: Play and pause a video
       permalink: /cookbook/plugins/play-video
-    - title: Transforming assets at build time
+    - title: Transform assets at build time
       permalink: /ui/assets/asset-transformation
 
 - title: Navigation & routing
@@ -329,7 +326,7 @@
       permalink: /cookbook/navigation/set-up-universal-links
     - title: Configure web URL strategies
       permalink: /ui/navigation/url-strategies
-      
+
 - title: Animations & transitions
   permalink: /ui/animations
   children:
@@ -356,7 +353,7 @@
       permalink: /cookbook/effects/staggered-menu-animation
     - title: API overview
       permalink: /ui/animations/overview
-      
+
 - title: Accessibility & internationalization
   permalink: /ui/accessibility-and-internationalization
   children:
@@ -411,7 +408,7 @@
           permalink: /cookbook/networking/background-parsing
     - title: Persistence
       permalink: /data-and-backend/persistence
-      children: 
+      children:
         - title: Store key-value data on disk
           permalink: /cookbook/persistence/key-value
         - title: Read and write files
@@ -424,7 +421,7 @@
         - title: Overview
           permalink: /data-and-backend/firebase
         - title: Add Firebase to your Flutter app
-          permalink: https://firebase.google.com/docs/flutter/setup?platform=ios
+          permalink: https://firebase.google.com/docs/flutter/setup
     - title: Google APIs
       permalink: /data-and-backend/google-apis
 
@@ -506,7 +503,7 @@
           permalink: /platform-integration/web/install-web
         - title: Build a web app
           permalink: /platform-integration/web/building
-        - title: WebAssembly
+        - title: Compile to WebAssembly
           permalink: /platform-integration/web/wasm
         - title: Customize app initialization
           permalink: /platform-integration/web/initialization
@@ -762,7 +759,7 @@
 - title: Resources
   permalink: /resources
   children:
-    - header: Learning
+#    - header: Learn
     - title: FAQ
       permalink: /resources/faq
     - title: Books
@@ -775,23 +772,23 @@
       permalink: /resources/bootstrap-into-dart
     - title: Get support
       permalink: /resources/support
-    - header: Contributing
-    - title: Create useful bug reports
-      permalink: /resources/bug-reports
-    - title: Contribute to Flutter
-      permalink: https://github.com/flutter/flutter/blob/main/CONTRIBUTING.md
-    - title: Design documents
-      permalink: /resources/design-docs
-
-- title: Reference
-  permalink: /reference
-  expanded: true
-  children:
-    - title: Who is Dash?
-      permalink: /dash
-    - title: Widget index
-      permalink: /reference/widgets
-    - title: API reference
-      permalink: https://api.flutter.dev
-    - title: flutter CLI reference
-      permalink: /reference/flutter-cli
+    - divider
+    - title: Contribute
+      children:
+      - title: Create useful bug reports
+        permalink: /resources/bug-reports
+      - title: Contribute to Flutter
+        permalink: https://github.com/flutter/flutter/blob/main/CONTRIBUTING.md
+      - title: Discover proposed features
+        permalink: /resources/design-docs
+    - title: Reference
+      permalink: /reference
+      children:
+        - title: Who is Dash?
+          permalink: /dash
+        - title: Widget index
+          permalink: /reference/widgets
+        - title: flutter CLI
+          permalink: /reference/flutter-cli
+        - title: API docs
+          permalink: https://api.flutter.dev

src/_sass/base/_variables.scss

@@ -1,3 +1,5 @@
+@use 'sass:color';
+
 // Colors
 $flutter-color-blue: #043875;
 $flutter-color-teal: #158477;
@@ -18,7 +20,7 @@ $site-color-light-grey: #DADCE0;
 $site-color-sub-grey: #8d9399;
 $site-color-nav-links: #6E7274;
 $site-color-body: #212121; // Poor contrast with links
-$site-color-body-light: rgba(0, 0, 0, .8);
+$site-color-body-light: color.scale($site-color-body, $lightness: 20%);
 $site-color-footer: #303c42;
 $site-color-primary: $flutter-color-blue-500;
 $twitter-color: #60CAF6;
@@ -36,7 +38,7 @@ $site-header-height: 66px;
 $site-footer-md-default-height: 140px;
 $site-content-top-padding: 40px;
 $site-content-max-width: 960px;
-$site-sidebar-top-padding: 24px;
+$site-sidebar-top-padding: 16px;
 $site-sidebar-side-padding: 16px;
 $site-nav-mobile-side-padding: 20px;
 $site-spacer: 1rem;

src/_sass/components/_sidebar.scss

@@ -1,3 +1,5 @@
+@use 'sass:color';
+
 @use '../base/variables' as *;
 @use '../vendor/bootstrap';
 
@@ -60,7 +62,7 @@
     font-weight: bootstrap.$font-weight-bolder;
     font-size: bootstrap.$font-size-base;
     user-select: none;
-    color: lighten($site-color-body-light, 20%);
+    color: color.scale($site-color-body-light, $lightness: 15%);
   }
 
   .nav-link {
@@ -104,6 +106,10 @@
       padding: 0 $site-sidebar-side-padding;
     }
 
+    > .nav-header:first-child {
+      padding-top: 0;
+    }
+
     > .nav-item {
       > .nav-link {
         @include nav-link-active-style;

src/content/get-started/fundamentals/layout.md

@@ -5,8 +5,8 @@ prev:
   title: Widgets
   path: /get-started/fundamentals/widgets
 next:
-    title: State management
-    path: /get-started/fundamentals/state-management
+  title: State management
+  path: /get-started/fundamentals/state-management
 ---
 
 Given that Flutter is a UI toolkit,
@@ -22,6 +22,7 @@ Flutter's most common layout errors,
 the dreaded "unbounded constraints" error.
 
 ## Understanding layout in Flutter
+
 The core of Flutter's layout mechanism is widgets. 
 In Flutter, almost everything is a widget — even 
 layout models are widgets. 

src/content/get-started/fundamentals/state-management.md

@@ -2,7 +2,7 @@
 title: State management
 description: Learn how to manage state in Flutter.
 prev:
-  title: Layouts
+  title: Layout
   path: /get-started/fundamentals/layout
 next:
   title: Handling user input

src/content/get-started/fundamentals/widgets.md

@@ -5,7 +5,7 @@ prev:
   title: Intro to Dart
   path: /get-started/fundamentals/dart
 next:
-  title: Layouts
+  title: Layout
   path: /get-started/fundamentals/layout
 ---
 

src/content/reference/index.md

@@ -0,0 +1,6 @@
+---
+layout: toc
+title: Flutter reference docs
+short-title: Reference
+description: Miscellaneous reference docs relating to Flutter.
+---