Index: /main/waeup.sirp/trunk/docs/source/bugs.rst
===================================================================
--- /main/waeup.sirp/trunk/docs/source/bugs.rst	(revision 5339)
+++ /main/waeup.sirp/trunk/docs/source/bugs.rst	(revision 5339)
@@ -0,0 +1,18 @@
+.. _reporting-bugs:
+
+Reporting Bugs in `waeup.sirp`
+******************************
+
+The developers would like to know of any deficiencies you find in
+`waeup.sirp`.
+
+Also telling about errors and shortcomings in the documentation are
+welcome. Please write to ``henrik at waeup dot org`` if you find any.
+
+.. seealso::
+
+   `How to Report Bugs Effectively
+   <http://www.chiark.greenend.org.uk/~sgtatham/bugs.html>`_ Article
+   which goes into some detail about how to create a useful bug
+   report. This describes what kind of information is useful and why
+   it is useful.
Index: /main/waeup.sirp/trunk/docs/source/contents.rst
===================================================================
--- /main/waeup.sirp/trunk/docs/source/contents.rst	(revision 5338)
+++ /main/waeup.sirp/trunk/docs/source/contents.rst	(revision 5339)
@@ -14,4 +14,6 @@
    copyright
    glossary
+   bugs
+   documentation
 
 Indices and tables
Index: /main/waeup.sirp/trunk/docs/source/documentation.rst
===================================================================
--- /main/waeup.sirp/trunk/docs/source/documentation.rst	(revision 5339)
+++ /main/waeup.sirp/trunk/docs/source/documentation.rst	(revision 5339)
@@ -0,0 +1,23 @@
+About these documents
+*********************
+
+These documents are generated from `reStructuredText
+<http://docutils.sf.net/rst.html>`_ sources by `Sphinx`_, an excellent
+document processor specifically written for the Python documentation
+by Georg Brandl and contributors.
+
+Development of this documentation is organized by Uli Fouquet (``uli
+at waeup dot org``) and Henrik Bettermann (``henrik at waeup dot
+org``). We're always looking for volunteers wanting to help with the
+docs, so feel free to send a mail there!
+
+Many thanks go to:
+
+* the `docutils <http://docutils.sf.net/>`_ project for creating
+  reStructuredText and the docutils suite;
+* Georg Brandl for his `sphinx` package.
+
+See :ref:`reporting-bugs` for information how to report bugs in
+`waeup.sirp` itself.
+
+.. _Sphinx: http://sphinx.org/
