Order of Docs

Dorcs can order pages automatically or follow an explicit navigation tree.

Best option for most sites

Use nav.items when you need stable labels and exact ordering across folders.

Automatic ordering

Without nav.items, Dorcs uses the file tree and common ordering hints:

numeric prefixes such as 01_, 02_
front matter hints like order
alphabetical fallback

Example:

docs/
├── 01_intro.md
├── 02_install.md
└── 03_deploy.md

Explicit ordering

nav:
  items:
    - Home: index.md
    - Guides:
        page: guides/index.md
        items:
          - Install: guides/install.md
          - Deploy: guides/deploy.md

Use this when:

filenames should stay technical
labels should be more readable
multiple sections need custom grouping

Recommendation

Use filename prefixes for small sites. Use nav.items once the docs become product-facing or multi-section.