Merge pull request #188 from 0xMiden/brian/sidebar-sections-flatten-develop

docs: add sidebar section headers and flatten develop/

Author: BrianSeong99

.github/workflows/cut-versions.yml

@@ -4,7 +4,7 @@
 #
 # v0.4 Information Architecture:
 #   - Core Concepts docs (miden-base, miden-vm, compiler, miden-node) → docs/core-concepts/
-#   - Builder docs (miden-tutorials, miden-client) → docs/builder/develop/tutorials/, docs/builder/tools/client/
+#   - Builder docs (miden-tutorials, miden-client) → docs/builder/tutorials/, docs/builder/tools/client/
 #
 # Workflow responsibilities:
 #   1. Check out external repos at pinned refs
@@ -152,7 +152,7 @@ jobs:
           # Clean directories that will be re-synced (v0.4 nested paths)
           rm -rf docs/core-concepts/miden-base docs/core-concepts/miden-vm docs/core-concepts/miden-node docs/core-concepts/compiler
           rm -rf docs/builder/tools/client
-          # Note: docs/builder/develop/tutorials is NOT fully cleaned to preserve local tutorials (e.g. miden-bank)
+          # Note: docs/builder/tutorials is NOT fully cleaned to preserve local tutorials (e.g. miden-bank)
 
           # Core Concepts docs → docs/core-concepts/*
           if [ -d "vendor/miden-base/docs/src" ]; then
@@ -180,11 +180,11 @@ jobs:
           fi
 
           # Builder docs → docs/builder/*
-          # Sync miden-tutorials into develop/tutorials (local tutorials are preserved)
+          # Sync miden-tutorials into tutorials (local tutorials are preserved)
           if [ -d "vendor/miden-tutorials/docs/src" ]; then
-            mkdir -p docs/builder/develop/tutorials
-            cp -r vendor/miden-tutorials/docs/src/* docs/builder/develop/tutorials/
-            echo "Synced miden-tutorials → docs/builder/develop/tutorials"
+            mkdir -p docs/builder/tutorials
+            cp -r vendor/miden-tutorials/docs/src/* docs/builder/tutorials/
+            echo "Synced miden-tutorials → docs/builder/tutorials"
           fi
 
           if [ -d "vendor/miden-client/docs/external/src" ]; then
@@ -200,7 +200,7 @@ jobs:
           echo "Builder subdirs:"
           ls -la docs/builder/ || true
           echo "Tutorials subdirs:"
-          ls -la docs/builder/develop/tutorials/ || true
+          ls -la docs/builder/tutorials/ || true
 
       - name: Cut version snapshot
         run: |
@@ -220,7 +220,7 @@ jobs:
           rm -rf docs/core-concepts/miden-node
           rm -rf docs/core-concepts/compiler
           rm -rf docs/builder/tools/client
-          # Note: tutorials live in docs/builder/develop/tutorials/ (authored content, not cleaned)
+          # Note: tutorials live in docs/builder/tutorials/ (authored content, not cleaned)
 
       - name: Commit snapshots
         run: |

.github/workflows/deploy-docs.yml

@@ -148,7 +148,7 @@ jobs:
           # Clean directories that will be re-synced (v0.4 nested paths)
           rm -rf docs/core-concepts/miden-base docs/core-concepts/miden-vm docs/core-concepts/miden-node docs/core-concepts/compiler
           rm -rf docs/builder/tools/client
-          # Note: docs/builder/develop/tutorials is NOT fully cleaned to preserve local tutorials (e.g. miden-bank)
+          # Note: docs/builder/tutorials is NOT fully cleaned to preserve local tutorials (e.g. miden-bank)
 
           # Core Concepts docs → docs/core-concepts/*
           if [ -d "vendor/miden-base/docs/src" ]; then
@@ -176,11 +176,11 @@ jobs:
           fi
 
           # Builder docs → docs/builder/*
-          # Sync miden-tutorials into develop/tutorials (local tutorials are preserved)
+          # Sync miden-tutorials into tutorials (local tutorials are preserved)
           if [ -d "vendor/miden-tutorials/docs/src" ]; then
-            mkdir -p docs/builder/develop/tutorials
-            cp -r vendor/miden-tutorials/docs/src/* docs/builder/develop/tutorials/
-            echo "Synced miden-tutorials → docs/builder/develop/tutorials"
+            mkdir -p docs/builder/tutorials
+            cp -r vendor/miden-tutorials/docs/src/* docs/builder/tutorials/
+            echo "Synced miden-tutorials → docs/builder/tutorials"
           fi
 
           if [ -d "vendor/miden-client/docs/external/src" ]; then
@@ -196,7 +196,7 @@ jobs:
           echo "Builder subdirs:"
           ls -la docs/builder/ || true
           echo "Tutorials subdirs:"
-          ls -la docs/builder/develop/tutorials/ || true
+          ls -la docs/builder/tutorials/ || true
 
       - name: Install deps
         run: npm install --frozen-lockfile

README.md

@@ -182,7 +182,7 @@ The `.github/workflows/deploy-docs.yml` workflow:
 1. Checks out this repository and all external source repos
 2. Ingests external docs into v0.4 IA structure:
    - Core Concepts docs → `docs/core-concepts/miden-base/`, `miden-vm/`, `compiler/`, `miden-node/`
-   - Builder docs → `docs/builder/develop/tutorials/`, `docs/builder/tools/client/`
+   - Builder docs → `docs/builder/tutorials/`, `docs/builder/tools/client/`
 3. Runs `npm run build` to generate the static site
 4. Deploys to GitHub Pages at `docs.miden.xyz`
 

docs/builder/develop/_category_.json

@@ -70,7 +70,7 @@ import DocCard from '@theme/DocCard';
     <DocCard
       item={{
         type: 'link',
-        href: './develop',
+        href: './tutorials/rust-compiler',
         label: 'Tutorials',
         description: 'Step-by-step guides for building applications on Miden.',
       }}

docs/builder/develop/index.md

@@ -158,7 +158,7 @@ npm run dev
 ```
 
 :::tip
-For detailed frontend setup guidance, see the [Tutorials section](../develop/tutorials/rust-compiler/).
+For detailed frontend setup guidance, see the [Tutorials section](../tutorials/rust-compiler/).
 :::
 
 ## Creating Accounts Programmatically

docs/builder/index.md

@@ -299,7 +299,7 @@ Congratulations! You've successfully completed the Miden smart contract quick st
 
 To deepen your knowledge, we recommend exploring the following resources:
 
-- Visit the [Tutorials section](../../develop/tutorials/rust-compiler/) for detailed, hands-on guides on topics such as contract interactions, advanced storage, custom note scripting, and integrating with external applications.
+- Visit the [Tutorials section](../../tutorials/rust-compiler/) for detailed, hands-on guides on topics such as contract interactions, advanced storage, custom note scripting, and integrating with external applications.
 - For in-depth technical explanations of core concepts, consult the [Core Concepts section](../../../core-concepts/) of the documentation. Here you'll find comprehensive information on Miden's architecture, account model, transaction lifecycle, and the underlying zero-knowledge technology that powers the network.
 
 The foundational patterns and concepts you've practiced in this Quick Start will enable you to build complex, privacy-preserving applications on the Miden network. Continue with the resources above to take your development further!

docs/builder/quick-start/accounts.md

@@ -1,4 +1,4 @@
 {
-  "label": "Miden Smart Contracts",
+  "label": "Smart Contracts",
   "position": 3
 }

docs/builder/quick-start/your-first-smart-contract/test.md

@@ -6,7 +6,7 @@ description: "Reference documentation for building Miden smart contracts in Rust
 
 # Miden Smart Contracts
 
-This section is the complete reference for building smart contracts on Miden using Rust and the Miden SDK (v0.10). If you're new to Miden, follow the hands-on [Miden Bank Tutorial](../develop/tutorials/rust-compiler/miden-bank/).
+This section is the complete reference for building smart contracts on Miden using Rust and the Miden SDK (v0.10). If you're new to Miden, follow the hands-on [Miden Bank Tutorial](../tutorials/rust-compiler/miden-bank/).
 
 All Miden Rust contracts compile under these constraints: `#![no_std]`, Rust 2024 edition.