diff --git a/README.rst b/README.rst
index 352ae6b..e55d440 100644
--- a/README.rst
+++ b/README.rst
@@ -2,132 +2,42 @@ Introduction
============
-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).
+plone.app.discussion is the commenting system used since Plone 4.1.
+It was initially developed as part of the Google Summer of Code 2009 by Timo Stollenwerk (student) and Martin Aspeli (mentor).
-.. note::
-
- Make sure you pin down plone.app.discussion to versions < 2.0 if you want to
- install it as an add-on product (see install instructions below for more
- details).
-
-Please report bugs to the `Plone bug tracker`_.
-
-.. _`Plone bug tracker`: http://dev.plone.org/plone/
-
-
-For the roadmap of the project see our `Pivotal Tracker`_.
-
-.. _`Pivotal Tracker`: http://www.pivotaltracker.com/projects/15135
-
-
-Requirements
-============
-
-Plone 3.3 or later.
-
-
-Plone 3.3.x Buildout Installation
-=================================
-
-To install plone.app.discussion, add the following code to your buildout.cfg::
-
- [buildout]
- ...
- extends =
- ...
- http://good-py.appspot.com/release/plone.app.discussion/1.0
-
- ...
-
- [versions]
- plone.app.discussion = 1.0
-
- ...
-
- [instance]
- ...
- eggs =
- ...
- plone.app.discussion
-
- ...
-
-
-Plone 4.0 Buildout Installation
-===============================
-
-To install plone.app.discussion, add the following code to your buildout.cfg::
-
- [buildout]
-
- ...
-
- versions = versions
-
- [versions]
- plone.app.discussion = 1.0
- zope.schema = 3.6.4
-
- ...
-
- [instance]
- ...
- eggs =
- ...
- plone.app.discussion
-
- ...
Add-on Products
===============
- `collective.autoresizetextarea
- `_
+ `_
(for auto-resizing the comment textarea while typing)
- `plone.formwidget.captcha
- `_
+ `_
(for Captcha spam protection)
- `plone.formwidget.recaptcha
- `_
+ `_
(for ReCaptcha spam protection)
- `collective.akismet
- `_
+ `_
(for Akismet spam protection)
- `collective.z3cform.norobots
- `_
+ `_
(provides a "human" captcha widget based on a list of questions/answers)
+Note: not all of these may be compatible with the current version of ``plone.app.discussion`` and ``Plone`` itself.
+
Documentation
=============
-- For developer documentation see
- `http://packages.python.org/plone.app.discussion
- `_.
-
-- For integrator/end-user documentation see
- `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.
+There is initial `documentation `_ but it is outdated.
+You will still get a feel for how the package is structured though.
Credits