[Telepathy-commits] [telepathy-doc/master] Blurb for contactinfo chapter

[Davyd Madeley]

---
 docs/book/C/contactinfo.xml |   19 +++++++++++++++++++
 1 files changed, 19 insertions(+), 0 deletions(-)

diff --git a/docs/book/C/contactinfo.xml b/docs/book/C/contactinfo.xml
index e5928db..0e41001 100644
--- a/docs/book/C/contactinfo.xml
+++ b/docs/book/C/contactinfo.xml
@@ -18,6 +18,25 @@
 
 <chapter id="chapter.contactinfo">
  <title>Accessing and Managing Contact Information</title>
+
+ <para>
+  Managing contact information, commonly known as the &quot;roster&quot;,
+  is a big part most clients. This includes handling things like a contact's
+  real name, presence and status, avatar and client capabilities.
+ </para>
+
+ <para>
+  A list of handles usually comes from a channel with the
+  <link xref="sect.channel.groups">Group</link> interface (i.e. a chatroom
+  or a <link xref="sect.channel.contactlist">contact list</link>).
+ </para>
+
+ <para>
+  In general, a client will connect the relevant signals to receive updates
+  for presence, aliases, avatars, capabilities, and so on; and then use
+  the <link xref="sect.contactinfo.contacts">Contacts</link> interface to
+  bulk request the intial state.
+ </para>
   
  <sect1 id="sect.contactinfo.contacts">
   <title>Contacts</title>
-- 
1.5.6.5