docs: rename quick-start to get-started and fix sidebar overflow

README.md

@@ -211,7 +211,7 @@ The build uses:
 - **Never** manually copy external content into `docs/` (use CI/CD ingestion)
 - **Never** create root-level `docs/miden-base/`, `docs/miden-vm/`, etc. (use nested paths in `docs/core-concepts/`)
 - **Never** edit `versioned_docs/` directly (snapshots are immutable)
-- **Never** create a root-level `docs/quick-start/` (Get Started lives in `docs/builder/`)
+- **Never** create a root-level `docs/quick-start/` or `docs/get-started/` (Get Started lives in `docs/builder/`)
 
 ### Quick Reference
 
@@ -253,6 +253,6 @@ The site uses **Simple Analytics** for privacy-first, cookie-less metrics.
 ### Updating llms.txt
 
 Edit `static/llms.txt` directly. Content should:
-- List canonical entry points (Get Started, Builder, Design)
+- List canonical entry points (Get Started, Builder, Core Concepts)
 - Use relative paths (`/builder/get-started/`)
 - Avoid "Polygon Miden" branding (use "Miden" only)

docs/builder/migration/index.md

@@ -35,7 +35,7 @@ This guide is for:
 - **App developers** using `miden-objects`, `miden-lib`, or legacy MASM syntax
 - **Smart contract authors** using storage slots or note APIs
 
-If you're starting fresh on v0.13, you can skip this guide and go directly to the [Get Started guide](../get-started).
+If you're starting fresh on v0.13, you can skip this guide and go directly to the [Get Started](../get-started) guide.
 :::
 
 ---

docusaurus.config.ts

@@ -97,6 +97,7 @@ const config: Config = {
             redirects.push("/intro");
           }
           if (existingPath.startsWith("/builder/get-started")) {
+            // Redirect old quick-start paths to new get-started paths
             redirects.push(existingPath.replace("/builder/get-started", "/quick-start"));
             redirects.push(existingPath.replace("/builder/get-started", "/builder/quick-start"));
           }

src/custom/_sidebar.css

@@ -342,3 +342,51 @@ aside[class*="docSidebarContainer"] .menu__caret {
 .navbar-sidebar .menu__list-item-collapsible {
   border-radius: var(--radius-md);
 }
+
+/* ==========================================
+   4.6) SIDEBAR OVERFLOW HANDLING
+   Fixes #170 - long titles overflow in sidebar
+   ========================================== */
+
+/* Ensure sidebar container clips overflow */
+aside[class*="docSidebarContainer"] {
+  overflow-x: hidden;
+}
+
+/* Main menu element clips content */
+aside[class*="docSidebarContainer"] .menu {
+  overflow-x: hidden;
+}
+
+/* Menu links handle long text gracefully */
+.theme-doc-sidebar-menu .menu__link {
+  /* Allow natural word wrapping for better readability */
+  word-wrap: break-word;
+  overflow-wrap: break-word;
+  hyphens: auto;
+  /* Prevent horizontal overflow */
+  max-width: 100%;
+}
+
+/* Handle code elements within sidebar links */
+.theme-doc-sidebar-menu .menu__link code {
+  /* Prevent code from causing overflow */
+  word-break: break-all;
+  white-space: normal;
+  /* Reduce code styling in sidebar for compactness */
+  font-size: 0.9em;
+  padding: 0.1em 0.3em;
+}
+
+/* Category labels also need overflow handling */
+.menu__list-item-collapsible > .menu__link {
+  overflow: hidden;
+  text-overflow: ellipsis;
+  /* Single line truncation for category headers */
+  white-space: nowrap;
+}
+
+/* But leaf items (actual page links) can wrap to multiple lines */
+.theme-doc-sidebar-item-link .menu__link {
+  white-space: normal;
+}

versioned_docs/version-0.13/builder/migration/index.md

@@ -35,7 +35,7 @@ This guide is for:
 - **App developers** using `miden-objects`, `miden-lib`, or legacy MASM syntax
 - **Smart contract authors** using storage slots or note APIs
 
-If you're starting fresh on v0.13, you can skip this guide and go directly to the [Get Started](../get-started).
+If you're starting fresh on v0.13, you can skip this guide and go directly to the [Get Started](../get-started) guide.
 :::
 
 ---