README updated; known issues section added; prepare 2.0.4 release.

svn path=/plone.app.discussion/trunk/; revision=50079

CHANGES.txt

@@ -1,14 +1,16 @@
 Changelog
 =========
 
-2.0.4 (Unreleased)
+2.0.4 (2011-05-28)
 ------------------
 
 - Refactor/clean up the handleComment method.
   [timo]
   
 - Make handleComment method store comment attributes from form extenders. This 
-  allows us to extend the comment form with external add-ons.
+  allows us to extend the comment form with external add-ons. See
+  http://packages.python.org/plone.app.discussion/howtos/howto_extend_the_comment_form.html
+  for details.
   [timo]
 
 

README.txt

@@ -1,12 +1,10 @@
 Introduction
 ============
 
-plone.app.discussion aims to be the new commenting system for Plone. It was 
-initially developed as part of the Google Summer of Code 2009 by Timo 
-Stollenwerk (student) and Martin Aspeli (mentor).
-
-plone.app.discussion is an add-on product for Plone 3.3.x and 4.0.x and will be
-shipped as part of Plone 4.1. 
+plone.app.discussion replaces the old commenting system in Plone 4.1 and is also
+available as an add-on product for Plone 3 and 4. It was initially developed as 
+part of the Google Summer of Code 2009 by Timo Stollenwerk (student) and Martin 
+Aspeli (mentor).
 
 .. note::
 
@@ -119,6 +117,18 @@ Documentation
   <http://plone.org/products/plone.app.discussion/documentation>`_.
 
 
+Known Issues
+============
+
+- **ImportError: No module named owner**: You are trying to install 
+  plone.app.discussion 2.x on Plone < 4.1. Pin plone.app.discussion to a version
+  < 2.0.
+  
+- **KeyError: 'Interface `plone.app.discussion.interfaces.IDiscussionSettings` 
+  defines a field `moderator_email`, for which there is no record.'**: An
+  upgrade step was unsuccessful. Reinstall plone.app.discussion to fix this.
+
+
 Credits
 =======