(For the Docutils sprint at PyCon2007, see PyCon2007/DocutilsSprint. For the Docutils sprint at PyCon2006, see PyCon2006/Sprints/DocutilsSprint.)


PyConDC2004 is over. See A Week at PyCon DC 2004 for a narrative account of events.

For introductory information and information about the other sprints going on at PyConDC2004, please see SprintPlan2004.

We also had a birds-of-a-feather session; see DocutilsBof.

Also see the Docutils home page and the reStructuredText home page.


The sprints at PyConDC2004 were held from March 20 (Saturday) through March 23 (Tuesday), for a total of 4 days. I was there for all 4 sprint days, and sprinters joined in as they were able.

Please feel free to comment here or email me.


There was no cost to attend the sprints beyond being present.


Everyone was welcome! No prior Docutils hacking experience was required. Participants were either experienced Python programmers, or interested in documentation.

Here are the sprinters who attended:


This sprint and my participation at PyConDC2004 were sponsored by Silver Sponsor Wing IDE (Archaeopteryx Software), the Python Software Foundation (PSF), and individual contributors. Thank you all!

Sprint Topic Ideas

Each sprint day began with an interactive overview of the Docutils architecture and codebase.

I will update this page with actual results from the sprint. For now, here is the original list of ideas for the sprint, in no particular order:

There are more ideas in the Docutils to-do list.


Please feel free to add any comments you like. Include your name for feedback; anonymous comments OK too. I hope to see you at PyCon! -- David Goodger

I shan't be able to make PyCon (no surprise there), but I hope the sprint goes really well. I have no objection at all if one of the items of work is the pysource reader, whether based on my work or not - indeed, I'd love to see a working implementation out there. -- Tibs

I'd be very interested in working on the/a Python source code reader -- it seems like the giant missing piece of docutils. -- Ian Bicking

Two 2-day sprints would be better for me. I wasn't planning to attend any sprint, but Docutils is tempting me. I'd most likely attend Monday-Tuesday. I'm not that good at understanding intricate parser code, but perhaps I can work on some other aspect. My wishlist item is for the HTML generator to just produce an HTML fragment I can plug into a larger page, rather than all the header/footer/style stuff it adds. There has also been much interest in our local Python user group about having a ReST syntax in MoinMoin. -- Mike Orr

An enhanced client API with better support for writing fragments would be really nice to have; I'd be willing to spend some time on that as well. Each time I have tried to make a simple script that used docutils in some way, the API has been difficult to figure out. It may be that documentation is all that's needed, or just a more-visible entry point into existing documentation, but I know how hard that is to do. I think it would be worth having at least a little brain-storming session to figure out where people are getting hung up on the API and letting you tell us how much of it is there in some form already, and guiding an effort to make it more effectively exposed. Whether that's documentation, a little code, or a pile of new stuff, I don't know, but my past explorations make me think there's some limited amount of "API stuff" that needs to be done. It is unlikely I'll be able to sprint on this topic Monday/Tuesday though. -- Fred Drake

I'll probably be there for all four days. Anyone who's interested in automatic API documentation generation might want to take a look at EpyDoc, which currently supports reStructuredText. I'd like to work on extending it with better docutils support, and improve it in other ways. -- Edward Loper

I use EpyDoc quite a bit, and would like to help with it's docutils support. And, just in general, would like to help out the docutils project. -- Tracy Ruggles

I'd love to get the DocBook writer finished up -- I think it's pretty close. It needs tests, better bibliographic field handling, and probably a bit of polishing. -- Ollie Rutherfurd

DocutilsSprint (last edited 2015-01-10 12:15:15 by WolfgangMaier)

Unable to edit the page? See the FrontPage for instructions.