Sphinx documentation generator
The most recommended of 6 documentation generators
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.
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.
29 people gave an opinion
- recommend it
- 19
- criticize it
- 10
- approval share
- 66%
Recommended in 6 of 13 months
- November 2025: recommended
- December 2025: not recommended
- January 2026: recommended
- February 2026: not recommended
- March 2026: recommended
- April 2026: recommended
- May 2026: not recommended
- June 2026: not recommended
- July 2026: not recommended
- August 2026: not recommended
- September 2026: recommended
- October 2026: recommended
- November 2026: not recommended (month in progress)
Why it doesn’t carry the badge
- 19 people recommend itNeeds 10 or more, met.
- 1.9 recommenders for every criticNeeds 2 to 1 or better, not met.
- Recommended in 6 of 13 monthsNeeds 4 or more, met.
The same three rules apply to every product, and the badge can’t be bought. How the badge works
What people say about it
The reasons people give, with the number of comments that give each one. Open a reason to read what they said.
Why people recommend it
Each mark is one comment
Good for structured docs with cross-references
“AsciiDoc and RST/Sphinx are definitely more powerful for structured documentation with cross-references, includes, and admonitions.”
Comment from 11 Jan 2026 in “Show HN: Ferrite – Markdown editor in Rust with native Mermaid diagram rendering” “are much better suited to build software documentation with cross-references”
Comment from 11 Jan 2026 in “Show HN: Ferrite – Markdown editor in Rust with native Mermaid diagram rendering” Builds websites from Markdown sources
“I use Sphinx to make a nice website from the markdown sources”
Comment from 23 Sep 2026 in “The GitHub wiki is an anti-pattern (2022)” “Myst with Sphinx is great.”
Comment from 27 Apr 2026 in “Quarkdown – Markdown with Superpowers”
Other documentation generators people recommend
The four most recommended other documentation generators, with the same counts for each, so you can compare like for like. The tick on each bar marks the 2 to 1 line the badge needs.
| Product | Recommend | Criticize | Approval | Months | Owned | Badge |
|---|---|---|---|---|---|---|
| Sphinx documentation generatorThis page | 19 | 10 | 66% | 6 | — | — |
| Code Wiki | 14 | 13 | 52% | 5 | — | — |
| Mintlify | 11 | 12 | 48% | 7 | — | — |
| Astro Starlight | 8 | 1 | 89% | 7 | — | — |
| Material for MkDocs | 8 | 3 | 73% | 2 | — | — |
What people said
28 of the 29 comments that mention it, newest first. Each links to the original comment.
“As sphinx and typst support unicode it just works.”
“I think this is really useful.”
“I like that it tests whether the person understands the change”
“I think this should kick in before any code is written not before any code is pushed.”
“I think this could be really useful.”
“I really don’t think it’ll stop anything”
“Love this idea, it’s way too easy to get lazy with AI”
“All of this to just avoid knowing what you're doing.”
“It keeps me focused an helps me do a structured review.”
“It’s a neat idea, i think it’ll really take off”
“I think I don't like being questioned by someone who I expect to work like magic.”
“what if AI hallucinates during the check?”
“This is cute and novel, but practically useless.”
“Tools like this will be the new warning voice that told people like us 5 to 10 years ago to never copy code from stackoverflow that you didn't understand.”
“I... don't... think this is going to work...?”
“I use Sphinx to make a nice website from the markdown sources”
“they are too complicated, bloated, not easy to organize notes”
“Myst with Sphinx is great.”
“combined with something like sphinx that is almost exactly what you're looking for”
“the overengineering doesn't even solve problems better than the vanilla solutions out there like AsciiDoctor and Sphinx”
“AsciiDoc and RST/Sphinx are definitely more powerful for structured documentation with cross-references, includes, and admonitions.”
“are much better suited to build software documentation with cross-references”
“it's tough to find something that checks all the boxes I need”
“can do impressive things but becomes a huge pain to configure”
“the weird system that was Sphinx”
“While it is great for documentation, we used it for the whole website of a project, mainly because people in the team already understood it.”
“it was always hard with things like sphinx where the input must be files on disk”
“Sphinx is the king, with no markdown support.”
Counts come from 1,795,640 Hacker News comments, November 2025 to November 2026. How we count. Report a mistake.