Today I started writing up user documentation for the project I'm wrapping up. It's the first time I've used
reStructuredText, and I must say that I'm liking it. As far as structured text markup languages go, it's pretty comprehensive and not *too* obtrusive. It's definitely good enough for most technical documentation needs, and is in fact a
PEP Formatting Standard (see also
PEP 12 Source). Other items of interest, particularly to Python programmers, are:
I include the source links to show the relative cleanliness of the markup, which is the point of all
Structured Text formats.
sigh I thought I'd have more to say, but I'm really too tired. So - quick wrap up: I was pretty productive with this stuff right off the bat. Nice.
For "Zope", there is a
proposal to integrate reStructuredText into Zope, hopefully for 2.7.