# Where to Find Headroom Documentation: Complete Guide to the Wiki and MkDocs Site

> Find headroom documentation easily. Explore the wiki in the GitHub repo or visit the official MkDocs site for a complete guide to everything headroom.

- Repository: [Tejas Chopra/headroom](https://github.com/chopratejas/headroom)
- Tags: getting-started
- Published: 2026-06-21

---

**Headroom's documentation is located in the `wiki/` directory of the chopratejas/headroom repository and is published as a static site at https://chopratejas.github.io/headroom, configured via the [`mkdocs.yml`](https://github.com/chopratejas/headroom/blob/main/mkdocs.yml) file.**

Headroom is an open-source project that provides specialized tooling for data processing pipelines. Understanding where to find the headroom documentation is essential for developers integrating the SDK, configuring transforms, or deploying to Vertex AI. The project maintains comprehensive documentation using MkDocs, with source files stored directly in the repository.

## Documentation Structure in the Repository

The headroom documentation follows a standard MkDocs structure, keeping all user-facing guides and API references in a dedicated `wiki/` directory while using [`mkdocs.yml`](https://github.com/chopratejas/headroom/blob/main/mkdocs.yml) to define the site configuration.

### The MkDocs Configuration

The root of the repository contains [[`mkdocs.yml`](https://github.com/chopratejas/headroom/blob/main/mkdocs.yml)](https://github.com/chopratejas/headroom/blob/main/mkdocs.yml), which drives the documentation site generation. This configuration file points the `docs_dir` parameter to the `wiki` directory, sets the site URL to `https://chopratejas.github.io/headroom`, and defines the navigation structure that appears in the header menu.

### The Wiki Directory

All reference and guide pages reside as Markdown files in the [`wiki/`](https://github.com/chopratejas/headroom/tree/main/wiki) folder. This directory contains the complete source content that MkDocs renders into the static site, including installation guides, API references, and integration tutorials.

## Key Documentation Files

The headroom documentation covers specific technical domains through dedicated markdown files:

- **[[`wiki/getting-started.md`](https://github.com/chopratejas/headroom/blob/main/wiki/getting-started.md)](https://github.com/chopratejas/headroom/blob/main/wiki/getting-started.md)** – Installation instructions and initial setup steps
- **[[`wiki/quickstart.md`](https://github.com/chopratejas/headroom/blob/main/wiki/quickstart.md)](https://github.com/chopratejas/headroom/blob/main/wiki/quickstart.md)** – Fast-track tutorial for new users
- **[[`wiki/api.md`](https://github.com/chopratejas/headroom/blob/main/wiki/api.md)](https://github.com/chopratejas/headroom/blob/main/wiki/api.md)** – Complete REST API reference documentation
- **[[`wiki/sdk.md`](https://github.com/chopratejas/headroom/blob/main/wiki/sdk.md)](https://github.com/chopratejas/headroom/blob/main/wiki/sdk.md)** – Detailed SDK usage guide and implementation patterns
- **[[`wiki/transforms.md`](https://github.com/chopratejas/headroom/blob/main/wiki/transforms.md)](https://github.com/chopratejas/headroom/blob/main/wiki/transforms.md)** – Pipeline architecture documentation covering SmartCrusher, CacheAligner, and compression transforms
- **[[`wiki/vertex.md`](https://github.com/chopratejas/headroom/blob/main/wiki/vertex.md)](https://github.com/chopratejas/headroom/blob/main/wiki/vertex.md)** – Google Vertex AI integration guidelines
- **[[`wiki/troubleshooting.md`](https://github.com/chopratejas/headroom/blob/main/wiki/troubleshooting.md)](https://github.com/chopratejas/headroom/blob/main/wiki/troubleshooting.md)** – Common issues and debugging strategies

Additionally, the [[`README.md`](https://github.com/chopratejas/headroom/blob/main/README.md)](https://github.com/chopratejas/headroom/blob/main/README.md) file at the repository root provides a high-level project overview with quick installation snippets and direct links to the full documentation site.

## How to Access Headroom Documentation

Developers can access the headroom documentation through three primary methods, depending on whether they need the rendered web experience or direct source access.

### Online via GitHub Pages

The rendered documentation site is available at **https://chopratejas.github.io/headroom**. This site provides searchable documentation with navigation that mirrors the `nav` section of [`mkdocs.yml`](https://github.com/chopratejas/headroom/blob/main/mkdocs.yml). Every markdown file in the `wiki/` directory appears as a menu item on the live site.

### In-Repository on GitHub

Browse the `wiki/` folder directly on GitHub at `https://github.com/chopratejas/headroom/tree/main/wiki`. Each `.md` file can be opened to view the raw Markdown source, which is useful for checking specific documentation versions or contributing edits via pull requests.

### Local Development Server

For offline reading or documentation development, clone the repository and serve the site locally using MkDocs:

```bash

# Clone the repository

git clone https://github.com/chopratejas/headroom.git
cd headroom

# Install MkDocs (requires Python)

pip install mkdocs

# Serve the documentation locally

mkdocs serve

```

The site will be available at `http://127.0.0.1:8000`, allowing you to preview changes before committing them.

## Summary

- **Primary Location**: All headroom documentation source files live in the `wiki/` directory of the chopratejas/headroom repository.
- **Configuration**: The [`mkdocs.yml`](https://github.com/chopratejas/headroom/blob/main/mkdocs.yml) file controls site generation and navigation structure.
- **Live Site**: https://chopratejas.github.io/headroom provides the rendered, searchable documentation.
- **Key Files**: Reference guides for the SDK, API, transforms, and Vertex AI integration are maintained as separate Markdown files in `wiki/`.
- **Local Access**: Run `mkdocs serve` to build and view documentation locally at `http://127.0.0.1:8000`.

## Frequently Asked Questions

### Where is the headroom documentation hosted?

The headroom documentation is hosted on GitHub Pages at https://chopratejas.github.io/headroom. The site is built automatically from the Markdown files in the `wiki/` directory using MkDocs, as configured in the [`mkdocs.yml`](https://github.com/chopratejas/headroom/blob/main/mkdocs.yml) file at the repository root.

### How do I run the headroom documentation locally?

Clone the chopratejas/headroom repository, install MkDocs with `pip install mkdocs`, and run `mkdocs serve` from the repository root. This starts a local development server at `http://127.0.0.1:8000` where you can preview the documentation before the changes are published to the live site.

### What specific topics are covered in the wiki/transforms.md file?

The [[`wiki/transforms.md`](https://github.com/chopratejas/headroom/blob/main/wiki/transforms.md)](https://github.com/chopratejas/headroom/blob/main/wiki/transforms.md) file contains detailed documentation for the pipeline architecture, including the SmartCrusher compression system, CacheAligner implementations, and other transform operations used in data processing workflows. This file serves as the complete technical reference for understanding how headroom processes data transformations.

### Is there a quick reference available without browsing the full wiki?

Yes, the [[`README.md`](https://github.com/chopratejas/headroom/blob/main/README.md)](https://github.com/chopratejas/headroom/blob/main/README.md) file at the repository root provides a condensed overview with installation instructions and quick links. For detailed API references or SDK integration guides, however, you should consult the full documentation in the `wiki/` directory or the published site at https://chopratejas.github.io/headroom.