> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stackra.figentra.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 0002 — Documentation on Mintlify

> Accepted · 2026-10-19

> [!NOTE]
>
> Amended by
> [0199](/adr/0199-developer-experience-create-stackra-app-upgrades-stackra-dev-and-docs): the docs
> site information architecture.

## Context

The docs need to live in the repository, be reviewed with the code and be checked in CI.

## Decision

The docs are a workspace member at `apps/docs`, built with Mintlify (`docs.json` and MDX in `apps/docs/src`). ADRs are pages under `adr/`.
GitBook was considered and rejected: Git Sync has no local preview or build step, so it can't take part in `pnpm verify`.

## Consequences

* `mint validate` (build) and `mint broken-links` (lint) run in the turbo graph.
* Hosting is Mintlify's, connected to the repository through the Mintlify GitHub app.

## Enforcement

The `@figentra/docs` member's `build` (`mint validate`) and `lint` (`mint broken-links`) tasks run inside the turbo graph.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.