From 964c3c0d9700576970a40de526b6a7dd5007bb1f Mon Sep 17 00:00:00 2001
From: Timo Stollenwerk <timo@zmag.de>
Date: Sat, 28 May 2011 11:49:47 +0000
Subject: [PATCH] README updated; known issues section added; prepare 2.0.4
 release.

svn path=/plone.app.discussion/trunk/; revision=50079
---
 CHANGES.txt |  6 ++++--
 README.txt  | 22 ++++++++++++++++------
 2 files changed, 20 insertions(+), 8 deletions(-)

diff --git a/CHANGES.txt b/CHANGES.txt
index 1e60f19..966a24f 100644
--- a/CHANGES.txt
+++ b/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]
 
 
diff --git a/README.txt b/README.txt
index 8e14b7f..f0bd4b7 100644
--- a/README.txt
+++ b/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
 =======