What is docutils and why would I want to use it?
“. When I click on it, I’d be taken to a page that was written from a marketing perspective: it would be to the point and show me, as, say, a typical programmer, the key features of docutils and the key benefits to me. To be objective, it should also include what are felt to be current warts along with the plan to fix them. Most importantly, it would show me the raw markup text next to what it would look like transformed by some particular tool into “nice-looking” markup. I came across a python file which apparently had some docutils markup in it, but, alas, there was no link to click on to see how that would e.g. get transformed into HTML. I’ve seen and used other markup stuff (Web, doxygen, written my own, etc.), but never much liked what their raw text looked like. I liked the idea of docutils having a simple to read markup that tried not to get in the way — this is critical, because one has to assume that the reader doesn’t have the ability to see the markup in another form. The b
