Skip to main content

Docs site structure

This page documents the structural decisions behind the portfolio site: the navigation hierarchy, URL schema, and the logic that connects them.

The site has two levels of navigation.

Level 1: Sections (sidebar categories): seven thematic areas, each representing a distinct skill cluster. Numbered to communicate that the order is intentional, not arbitrary.

Level 2: Pages (sidebar items): individual exhibits, guides, or reference documents within each section. Maximum two levels for most sections. The Technical Documentation section goes three levels deep to accomodate the guides that each contain multiple pages.

The hierarchy is deliberately shallow. A reader should reach any page in at most three clicks from the home page.

URL schema​

URLs follow a consistent pattern that mirrors the sidebar hierarchy. No exceptions.

/                                    → home
/{section}/                          → section overview
/{section}/{page}                    → section page
/{section}/{sub-section}/{page}      → deep page (tech docs only)

URL design decisions​

Kebab-case throughout: No underscores, no camelCase. Consistent, readable, and compatible with all static site generators.

Section slugs match sidebar labels: /product-ideation/ maps to "1 · Product ideation" in the sidebar. No mismatch between what the reader sees and what the browser shows.

Trailing slash on section roots, none on leaf pages: Section roots (/product-ideation/) render the section overview. Leaf pages (/product-ideation/design-artifacts) render individual pages. This distinguishes containers from content.

No date-based or version-based URLs: This is a portfolio, not a blog or versioned product. Date prefixes add noise without adding navigability.