3 ms·
I frequently write documentation with sphinx, over 30 pages long. rST is a blessing for me. Markdown doesn't even get near. It's fine for some 20 line README o
by buster 12y ago
I frequently write documentation with sphinx, over 30 pages long.
rST is a blessing for me. Markdown doesn't even get near.
It's fine for some 20 line README on github but that's about it.
- aidenn0 12y agoI'm with you there in that I couldn't imagine writing 30 pages of markdown. For something like extensive documentation, I could imagine rST winning, particularly since there is a standard syntax for extending it. I still mostly use LaTeX for documentation though.
- buster 12y agoYou should give sphinx + latex a try. I have my own cookiecutter template for docs and it's never been easier and fast to write some good looking documents.