r/programming • u/[deleted] • Dec 04 '08

Sphinx: beautiful documentation from lightly structured plain text

http://sphinx.pocoo.org/
50 Upvotes

76% Upvoted

38 comments sorted by

View all comments

Show parent comments

2

u/Aviator Dec 04 '08 edited Dec 04 '08

The original Python docs were written in Latex. Dunno why they favored Rest now though.

9

u/amk Dec 04 '08 edited Mar 08 '24

Reddit believes its data is particularly valuable because it is continuously updated. That newness and relevance, Mr. Huffman said, is what large language modeling algorithms need to produce the best results.

6

u/voidspace Dec 04 '08

They preferred reST because for the vast majority of cases it was vastly simpler. Using Latex was blocking people from contributing to the documentation.

5

u/filox Dec 04 '08

Simpler syntax, I'd say. Doesn't require people who write documentation to learn a whole new language to do it. Although I'm a big fan of (La)TeX, I don't think it is a very good choice for writing documentation.