Docutils Bugs

Author: David Goodger; open to all Docutils developers
Contact: goodger@python.org
Date: 2005-04-25 03:12:00 +0200 (Mon, 25 Apr 2005)
Revision: 3252
Copyright: This document has been placed in the public domain.

Bugs in Docutils?!? Yes, we do have a few. Some are old-timers that tend to stay in the shadows and don't bother anybody. Once in a while new bugs are born. From time to time some bugs (new and old) crawl out into the light and must be dealt with. Icky.

This document describes how to report a bug, and lists known bugs.

Contents

How To Report A Bug

If you think you've discovered a bug, please read through these guidelines before reporting it.

First, make sure it's a new bug:

If you're not sure, please ask on the docutils-users@lists.sourceforge.net [1] mailing list first.

If it's a new bug, the most important thing you can do is to write a simple description and a recipe that reproduces the bug. Try to create a minimal document that demonstrates the bug. The easier you make it to understand and track down the bug, the more likely a fix will be.

Now you're ready to write the bug report. Please include:

The best place to send your bug report is to the SourceForge Bug Tracker. That way, it won't be misplaced or forgotten. In fact, an open bug report on SourceForge is a constant irritant that begs to be squashed.

Thank you!

(This section was inspired by the Subversion project's BUGS file.)

[1]Due to overwhelming amounts of spam, the docutils-users@lists.sourceforge.net mailing list has been set up for subscriber posting only. Non-subscribers who post to docutils-users will receive a message with "Subject: Your message to Docutils-users awaits moderator approval". Legitimate messages are accepted and posted as soon as possible (a list administrator must verify the message manually). If you'd like to subscribe to docutils-users, please visit <http://lists.sourceforge.net/lists/listinfo/docutils-users>.

Known Bugs

Also see the SourceForge Bug Tracker.