See below...

* Update docs on message carbons and stanza forwarding.
* Mention latest bug fix.

docs/CHANGES.rst

@@ -5,6 +5,8 @@ Changelog
 ------------------
 
 * Converse.js now responds to XEP-0030: Service Discovery requests. [jcbrand]
+* Bugfix. Roster groups all appear offline after page reload (with prebind).
+  See http://librelist.com/browser//conversejs/2014/8/26/problem-with-contact-list-everyone-is-offline/ [heban and jcbrand]
 * #212 Bugfix. Groups weren't being show again after the live filter was cleared. [jcbrand]
 * #215 (and also #75) XEP-0249: Direct MUC Invitations. [jcbrand]
 * #216 Contacts tab empty when using xhr_user_search. [hcderaad and jcbrand]

docs/source/index.rst

@@ -899,12 +899,26 @@ Default:  ``false``
 If set to true, debugging output will be logged to the browser console.
 
 message_carbons
-----------------------
+---------------
 
 Default:  ``false``
 
 Support for `XEP-0280: Message Carbons <https://xmpp.org/extensions/xep-0280.html>`_
 
+In order to keep all IM clients for a user engaged in a conversation,
+outbound messages are carbon-copied to all interested resources.
+
+This is especially important in webchat, like converse.js, where each browser
+tab serves as a separate IM client.
+
+Both message_carbons and `forward_messages`_ try to solve the same problem
+(showing sent messages in all connected chat clients aka resources), but go about it
+in two different ways.
+
+Message carbons is the XEP (Jabber protocol extension) specifically drafted to
+solve this problem, while `forwarded_messages`_ uses 
+`stanza forwarding <http://www.xmpp.org/extensions/xep-0297.html>`_
+
 expose_rid_and_sid
 ------------------
 
@@ -922,13 +936,18 @@ forward_messages
 
 Default:  ``false``
 
-If set to ``true``, sent messages will also be forwarded to other connected
-XMPP resources (e.g. chat clients) of the same user.
+If set to ``true``, sent messages will also be forwarded to the sending user's
+bare JID (their Jabber ID independent of any chat clients aka resources).
+
+This means that sent messages are visible from all the user's chat clients,
+and not just the one from which it was actually sent.
+
+This is especially important for web chat, such as converse.js, where each
+browser tab functions as a separate chat client, with its own resource.
 
-This is useful for example if converse.js is running in multiple tabs of the
-browser and you want sent messages to appear in all of them.
+This feature uses Stanza forwarding, see also `XEP 0297: Stanza Forwarding <http://www.xmpp.org/extensions/xep-0297.html>`_
 
-See also `XEP 0297: Stanza Forwarding <http://www.xmpp.org/extensions/xep-0297.html>`_
+For an alternative approach, see also `message carbons`_.
 
 fullname
 --------