diff --git a/README.md b/README.md index d9009d1c..6bd05e3f 100644 --- a/README.md +++ b/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) diff --git a/docs/builder/migration/index.md b/docs/builder/migration/index.md index db7af8cd..bd20e7ad 100644 --- a/docs/builder/migration/index.md +++ b/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. ::: --- diff --git a/docusaurus.config.ts b/docusaurus.config.ts index ac81dc07..6c258d7a 100644 --- a/docusaurus.config.ts +++ b/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")); } diff --git a/src/custom/_sidebar.css b/src/custom/_sidebar.css index d066f5c6..26ee23c1 100644 --- a/src/custom/_sidebar.css +++ b/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; +} diff --git a/versioned_docs/version-0.13/builder/migration/index.md b/versioned_docs/version-0.13/builder/migration/index.md index 1ba08c19..bd20e7ad 100644 --- a/versioned_docs/version-0.13/builder/migration/index.md +++ b/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. ::: ---