# Overview

`docforge` turns GSDFC-compliant Python docstrings into maintainable reference
documentation. It never edits source docstrings; it reads them, renders them,
and assembles a single MkDocs site from all available material.

## What it generates

| Kind      | Source                     | Output                          |
|-----------|----------------------------|---------------------------------|
| `lib`     | GSDFC docstrings           | `docs/lib/**` rendered markdown |
| `api`     | OpenAPI JSON spec          | `docs/api/**` rendered markdown |
| `wiki`    | Hand-written markdown      | `docs/wiki/**` (unchanged)      |
| `mcp`     | GSDFC docstrings + renderers | `docs/mcp/**` structured JSON |

## Combined build

One `mkdocs.yml` and one MkDocs build serve all kinds:

1. Wiki navigation is derived from the `docs/wiki/` file structure.
2. Generated library/API navigation is appended after it.
3. The wiki `index.md` becomes the site `Home`.

Hand-written wiki content is never overwritten or regenerated — only its
navigation is derived automatically.

## MCP bundle

`docs/mcp/**` is a self-contained, machine-readable reference generated from
docforge's own GSDFC docstrings. `doc-forge serve --mcp --module docforge`
serves it over MCP. See the [MCP Guide](05_development/04_mcp_guide.md).