diff --git a/README.rst b/README.rst
index ccb9e51a8..faf8a0a3b 100644
--- a/README.rst
+++ b/README.rst
@@ -40,8 +40,7 @@ and provide a link to the first ticket so we can track the issue(s) upstream.
 Documentation
 -------------
 
-The API documentation included with PIL has been converted (from HTML) to
-reStructured text (via pandoc) and is now `hosted by readthedocs.org <http://pillow.readthedocs.org>`_.
+The API documentation included with PIL has been converted (from HTML generated by pythondoc) to reStructured text (via pandoc) and is now `hosted by readthedocs.org <http://pillow.readthedocs.org>`_. This is a work in progress: in order to re-generate new API documentation, either `pythondoc <http://effbot.org/zone/pythondoc.htm>`_ will have to be run again or the pythondoc functionality must be converted to Sphinx.
 
 Python Imaging Library
 ======================