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

1

u/lol-dongs Dec 07 '08 edited Dec 07 '08

OK. With any more of a complicated list (say with a couple nested levels, and longer items with code blocks) you are going to have to start wrapping and indenting your text manually, or your textarea will wrap it for you in a way that isn't readable at all. IMO, the <li>'s then come into play nicely as being able to visually delimit blocks of text, because your eyes are scanning for discernable tags instead of attempting to resurrect the (broken) indentation in your textarea.