[DOC] Small update.

bzr revid: tde@openerp.com-20120420100751-55lnmbrygn1cln8v

addons/mail/doc/mail_message.rst

@@ -26,21 +26,3 @@ should inherit from this class and not from mail.message.
 
 Those changes aim at being able to distinguish the message content to the
 message itself.
-
-mail.group
-++++++++++
-
-A mail_group is a collection of users sharing messages in a discussion group. Group users are users that follow the mail group, using the subscription/follow mechanism of OpenSocial. A mail group has nothing in common wih res.users.group.
-Additional information on fields:
-
- - ``member_ids``: user member of the groups are calculated with ``message_get_subscribers`` method from mail.thread
- - ``member_count``: calculated with member_ids
- - ``is_subscriber``: calculated with member_ids
-
-res.users
-+++++++++
-
-OpenChatter updates the res.users class:
- - it adds a preference about sending emails when receiving a notification
- - make a new user follow itself automatically
- - create a welcome message when creating a new user, to make his arrival in OpenERP more friendly

addons/mail/doc/mail_thread.rst

@@ -3,7 +3,25 @@
 mail.thread and OpenChatter
 ===========================
 
-TODO
+API
++++
+
+Writing messages and notifications
+----------------------------------
+
+``message_append``
+
+Creates a new mail.message through message_create. The new message is attached 
+to the current mail.thread, containing all the details passed as parameters. 
+All attachments will be attached to the  thread record as well as to the 
+actual message.
+
+This method calls message_create that will handle management of subscription 
+and notifications, and effectively create the message.
+
+If ``email_from`` is not set or ``type`` not set as 'email', a note message 
+is created (comment or system notification), without the usual envelope 
+attributes (sender, recipients, etc.).
 
 mail.group
 ++++++++++