A collection of website polishing (#4784)

* Tighten up sidebar.

* Standardize CSS ordering between dev and prod.

Previously, the site would render one way in prod and another in dev! The issue was that vite was tree-shaking CSS and wound up re-ordering things in a way it thought was permissible, whereas in dev, without that optimization, the CSS was actuallys sequenced differently.

This led to a noticable huge margin in dev, but not in prod.

This commit asserts the official ordering the CSS layers, and then adds a fix for the left-margin issue. This should now standard dev and prod.

* Reduce code font-size from 16px to 14px.

* Improve main paragraph text rendering.

Use more readable line height and paragraph separation.

* Improve spacing after file tree.

* Fix sidebar inconsistencies on 3rd level of nav.

Author: josh-padnick

docs-starlight/src/styles/global.css

@@ -1,14 +1,14 @@
-@layer base, starlight, theme, components, utilities;
+@layer base, starlight.base, starlight.reset, starlight.core, starlight.content, starlight.components, starlight.utils, theme, components, utilities;
 @import '@astrojs/starlight-tailwind';
 @import "tailwindcss/theme.css" layer(theme);
 @import "tailwindcss/utilities.css" layer(utilities);
 
-@import "./buttons.css";
-@import "./contactform.css";
-@import "./lists.css";
+@import "./buttons.css" layer(components);
+@import "./contactform.css" layer(components);
+@import "./lists.css" layer(components);
 
 /* Starlight Fixes */
-@import "./starlight-search.css";
+@import "./starlight-search.css" layer(components);
 
 @font-face {
   font-family: 'Inter';
@@ -282,18 +282,35 @@ p code {
 
 #starlight__sidebar ul li {
   margin: 0;
-  padding-top: 0.5em;
-  padding-bottom: 0.5em;
 }
 
 #starlight__sidebar ul li ul li {
   padding-left: 1em;
 }
 
-#starlight__sidebar details summary {
+#starlight__sidebar ul li a {
+  font-size: calc(16 / 16 * 1rem);
+}
+
+#starlight__sidebar details  {
+  padding-left: 0;
+  margin-bottom: 10px;
+}
+
+#starlight__sidebar summary {
+  margin-top: 5px;
   padding-left: 0;
 }
 
+#starlight__sidebar details details details {
+  margin-bottom: 0;
+}
+
+#starlight__sidebar details details details summary {
+  margin-top: 0;
+  padding: 0.3em var(--sl-sidebar-item-padding-inline);
+}
+
 .opensourcecard {
   border-left: 0;
 }
@@ -302,6 +319,25 @@ p code {
   border-right: 0;
 }
 
+/* Main pane */
+
+.main-pane .sl-container {
+  margin-inline: 0;
+}
+
+.main-pane p {
+  line-height: 1.6;
+  margin-bottom: 1.5rem;
+}
+
+.main-pane starlight-file-tree {
+  margin-bottom: 1.8rem;
+}
+
+.main-pane .code {
+  font-size: calc(14 / 16 * 1rem);
+}
+
 starlight-toc h2 {
   background-color: var(--color-toc-background);
   color: var(--color-code-text);