-This package is a python module to interface with Ditz, a distributed issue
+.. README for PyDitz, in -*- rst -*- mode.
+This package is a python module to interface with issues produced by the
+Ditz distributed issue tracker (http://ditz.rubyforge.org).
+If you're interested in other Pythonic ways to to Ditzy things, you may
+also want to check out Pitz (http://pitz.tplus1.com).
+You'll need PyYAML (http://pyyaml.org).
for other things you can do.
-Note: if you're on a Linux box you can just type 'make' and 'make install'
+Note: if you're on a Linux box you can just type ``make`` and ``make
+install`` in the usual manner.