Overview

Librarian is the internal handbook for Provisionr. It is built on Astro Starlight with a customized three-level navigation system designed to scale as the company grows.

Structure

Content is organized into divisions, departments, and pages:

• Division — a top-level organizational area (Business, Customer, Engineering, Policies)
• Department — a team or function within a division (e.g. HR, Marketing, Platform)
• Page — a single document within a department

The top nav switches between divisions. The subnav shows departments within the current division. The left sidebar shows pages within the current department.

Content Format

All pages are written in Markdown (.md) or MDX (.mdx) and stored in src/content/docs/. Every page requires a frontmatter block:

---
title: Page Title
description: One sentence describing this page.
---

Content starts here.

MDX allows you to embed Astro components — see the Components section for what’s available.

Navigation Configuration

The sidebar hierarchy is defined in src/config/sidebar.json. Most departments use autogenerate, which means any file added to the directory appears automatically. Some sections use explicit slug entries to control ordering.

The top nav is configured in src/config/menu.en.json.

See the Navigation page for a full walkthrough.