diff --git a/README.rst b/README.rst
index dd3cbe146..5fa8f9524 100644
--- a/README.rst
+++ b/README.rst
@@ -2,18 +2,12 @@
 converse.js
 ===========
 
-``Converse.js`` implements an XMPP_ based instant messaging client in the browser.
+Converse.js_ implements an XMPP_ based instant messaging client in the browser.
 
 It is used by collective.xmpp.chat_, which is a Plone_ instant messaging add-on.
 
-The ultimate goal is to enable anyone to add Jabber chat functionality to their websites,
-regardless of the server backend.
-
-Currently this is not yet the case, as the code makes ajax calls to the (Plone) backend
-to fetch user info. This should be replaced with VCards (we're currently
-working on it).
-
-This library is therefore not (yet) usable independently.
+The ultimate goal is to enable anyone to add chat functionality to their websites, regardless of the backend.
+<p>This is currently possible, except for adding new contacts, which still makes an XHR call to the (Plone) backend to fetch user info.
 
 --------
 Features
@@ -22,19 +16,31 @@ Features
 It has the following features:
 
 * Manually or automically subscribe to other users.
-* With manual roster subscriptions, you can accept or decline contact requests.
-* Chat statuses (online, busy, away, offline)
-* Custom status message
-* Typing notifications (i.e when the contact is typing)
+* Accept or decline contact requests
+* Chat status (online, busy, away, offline)
+* Custom status messages
+* Typing notifications
 * Third person messages (/me )
 * Multi-user chat in chatrooms
-* Topics can be set for chatrooms
-* Full name and profile picture support
+* Chatroom Topics
+* vCard support
 
-A screencast of ``Converse.js`` in action via ``collective.xmpp.chat`` can be seen here_.
+-----------
+Screencasts
+-----------
 
-It depends on quite a few third party libraries, including strophe.js_,
-backbone.js_ and require.js_.
+* `In a static HTML page`_. Here we chat to external XMPP accounts on Jabber.org and Gmail.
+* `Integrated into a Plone site`_ via collective.xmpp.chat.
+
+------------
+Dependencies
+------------
+
+It depends on quite a few third party libraries, including:
+
+* strophe.js_
+* backbone.js_ 
+* require.js_
 
 -------
 Licence
@@ -42,6 +48,7 @@ Licence
 
 ``Converse.js`` is released under both the MIT_ and GPL_ licenses.
 
+.. _Converse.js: http://conversejs.org
 .. _strophe.js: http://strophe.im/strophejs
 .. _backbone.js: http:/backbonejs.org
 .. _require.js: http:/requirejs.org
@@ -51,3 +58,6 @@ Licence
 .. _MIT: http://opensource.org/licenses/mit-license.php
 .. _GPL: http://opensource.org/licenses/gpl-license.php
 .. _here: http://opkode.com/media/blog/instant-messaging-for-plone-with-javascript-and-xmpp
+.. _Screencast2: http://opkode.com/media/blog/2013/04/02/converse.js-xmpp-instant-messaging-with-javascript
+.. _`Integrated into a Plone site`: http://opkode.com/media/blog/instant-messaging-for-plone-with-javascript-and-xmpp
+.. _`In a static HTML page`: http://opkode.com/media/blog/2013/04/02/converse.js-xmpp-instant-messaging-with-javascript