Wiki structure

How this mdBook is organized — for editors adding or moving pages.

Directory layout

src/
  intro.md                 # Landing page (WIP banner)
  SUMMARY.md               # Sidebar navigation — edit this when adding pages

  choose-a-stack.md        # llama.cpp vs vLLM, what fits on a V620

  setup/                   # Hardware and ROCm install (getting-started first)
    getting-started.md
    hardware.md
    installing-rocm.md
    hsa-override.md
    host-firmware.md       # MMIO High / SR-IOV / large-BAR POST (only if the host will not POST)

  tuning/                  # V620-specific host tuning
    power.md
    ecc.md                 # Optional Pro-card ECC disable (~2 GB)
    p2p.md

  vllm/                    # vLLM serving on RDNA
    overview.md            # Section hub — start here
    onboarding.md          # Simple V620 happy path (Docker + fork launcher)
    running.md             # Images, docker run, quick start
    recipes.md             # Hub -extras and recipe-container presets
    flash-next.md          # Flash-Next status, card counts, AutoRound
    flash-next-serve.md    # Flash-Next serve lines (FULL_AND_PIECEWISE, #17, PP3)
    configuration.md       # Env vars, CUDA graphs, compose
    quantization.md        # GPTQ/AWQ, KV, MTP, INT4
    fork.md                # rdna_extras kernels + chronicle
    fork-progress.md       # Hub vs HEAD vs backlog snapshot
    host-venv.md           # Host uv venv (ROCm 7.2.0 / 7.14.0)
    serve-scripts.md       # tools/rdna/serve_rdna.sh recipes (fork checkout)
    images.md              # Building Docker images

  llama-cpp/               # llama.cpp and RDNA2 fork
    overview.md            # Section hub (points at choose-a-stack.md)
    building.md            # Stock llama.cpp build
    rdna2-overview.md      # Fork intro, build, requirements
    rdna2-benchmarks.md    # Author-reported numbers
    rdna2-speculative.md   # DFlash2, MTP, ngram
    rdna2-serving.md       # Launch, Docker, limits

  reference/               # Lookup tables
    env-vars.md            # Environment variable cheat-sheet
    verification.md        # What's verified vs community-reported

  troubleshooting/         # Problem → fix, by stack
    index.md               # Hub
    general.md
    vllm.md
    vllm-flash-next.md
    llama-cpp.md

  meta/                    # Wiki maintenance
    resources.md           # External links
    contributing.md
    structure.md           # This page

Conventions

Adding a new page

1. Pick the folder (or create one if it’s a new major topic).
2. Create src/<folder>/<topic>.md with a # title and optional WIP banner.
3. Add an entry to src/SUMMARY.md under the right section.
4. Link from the section overview.md if one exists.
5. Add verification rows if the page contains benchmarks or unconfirmed claims.
6. Run mdbook build — fix broken links before merging.

Splitting an existing page

1. Move shared intro to overview.md or trim the original.
2. Create focused sub-pages; link between them at the bottom (“Next steps”).
3. Update SUMMARY.md to nest sub-pages under the section.
4. Grep for old filename links: rg 'old-name\.md' src/
5. Update reference/verification.md section headers to match new paths.

What goes where?