Stories
Slash Boxes
Comments
NOTE: use Perl; is on undef hiatus. You can read content, but you can't post it. More info will be forthcoming forthcomingly.

All the Perl that's Practical to Extract and Report

use Perl Log In

Log In

[ Create a new account ]

darobin (1316)

darobin
  (email not shown publicly)
http://berjon.com/

Journal of darobin (1316)

Wednesday February 12, 2003
11:14 AM

Python finds out about POD, WikiText

[ #10546 ]

The python people are apparently now using something called reStructuredText (aka reST) for their documentation, as explained in this article. It's a bit like POD and a bit like WikiText, as ugly and brittle as any hybrid of those will naturally be.

Of course, when you scroll down you see one of their other official documentation formats, which is a derivate of DocBook. If that doesn't scare you, then you're ziggy or kip (Hi!). At any rate it would explain why they might consider reST an improvement.

Why is it that people continuously do their best to hurt themselves when it comes to documentation formats? Is there some form of lingering masochism? A fetish for the ugly?

The Fine Print: The following comments are owned by whoever posted them. We are not responsible for them in any way.
 Full
 Abbreviated
 Hidden
More | Login | Reply
Loading... please wait.