# Sphinx documentation generator

Hacker Approved page: https://hackerapproved.com/p/sphinx/

6 people recommended Sphinx documentation generator in Hacker News comments, 3 had mixed feelings and 3 criticized it, November 2025 to October 2026. It was recommended in 5 of 12 months, in 6 threads. It does not meet the Hacker Approved badge rule.

**Verdict:** Recommended for structured documentation with cross-references, and for whole project websites when the team already knows it. Common caveat: a huge pain to configure.

Summary written by Claude from 28 comments. It was written before the November 2026 recount, and 13 of those comments still count.

## Why people recommend it

- Builds websites from Markdown sources (2 comments in the sample): "I use Sphinx to make a nice website from the markdown sources" ([source](https://news.ycombinator.com/item?id=49820735)) "Myst with Sphinx is great." ([source](https://news.ycombinator.com/item?id=47924641))
- Good for structured docs with cross-references (1 comment in the sample): "are much better suited to build software documentation with cross-references" ([source](https://news.ycombinator.com/item?id=46575130))

## Other documentation generators people recommend

- [Mintlify](https://hackerapproved.com/p/mintlify/): 9 recommend, 2 mixed, 10 criticize
- [Astro Starlight](https://hackerapproved.com/p/astro-starlight/): 8 recommend, 0 mixed, 0 criticize
- [Code Wiki](https://hackerapproved.com/p/code-wiki/): 7 recommend, 7 mixed, 13 criticize

## The badge

A product earns the Hacker Approved badge when at least 10 people recommend it, recommenders outnumber critics at least 2 to 1 (mixed feelings count toward neither side), it was recommended in at least 4 of the 12 months and in at least 5 different threads, and no single thread supplies more than half of the people who recommend it. Health and money products are never badged.

## Cite as

Hacker Approved, "Sphinx documentation generator", https://hackerapproved.com/p/sphinx/ (6 recommend, 3 mixed, 3 criticize; Hacker News comments, November 2025 to October 2026).

Counts updated 2 Nov 2026, with data through October 31, 2026.