[gnome-devel-docs/wip/develguide] communications - refine and condense

[Ekaterina Gerasimova <egerasimov src gnome org>]

commit d7f4bddf1cdf093c9da6f402dc2a9c6b83db2136
Author: Allan Day <allanpday gmail com>
Date:   Thu May 1 15:33:03 2014 +0200

    communications - refine and condense

 platform-overview/C/overview-communication.page |   46 +++--------------------
 1 files changed, 6 insertions(+), 40 deletions(-)
---
diff --git a/platform-overview/C/overview-communication.page b/platform-overview/C/overview-communication.page
index ceda764..f7369b0 100644
--- a/platform-overview/C/overview-communication.page
+++ b/platform-overview/C/overview-communication.page
@@ -16,55 +16,21 @@
     <desc>Instant messaging, networking, social media, email, and calendaring support.</desc>
   </info>
 
-<title>Communication and social networking</title>
+<title>Communication &amp; social networking</title>
 
-<list>
- <item>
-  <p><em style="strong">Connect to instant messaging and social networking services</em></p>
- </item>
- <item>
-  <p><em style="strong">Set up multi-protocol connections with web services or other clients</em></p>
- </item>
- <item>
-  <p><em style="strong">Handle mail, online contacts and calendar services</em></p>
- </item>
-</list>
-
-<p>Get your users connected and communicating with their friends and contacts through instant messaging, 
social media, and email. GNOME's extensive communications stack gives you high-level, abstracted access to 
complicated instant messaging and email protocols. For more specialised communication needs, there's access 
to the nuts and bolts through lower level APIs too.</p>
+<p>GNOME's communication libraries give you high-level, abstracted access to instant messaging, email, and 
social media. For more specialised communication needs, there's access to the nuts and bolts through lower 
level APIs too.</p>
 
 <media type="image" mime="image/png" src="test_comm1.png" width="65%">
  <p>Empathy instant messaging client</p>
 </media>
 
-<section id="what">
- <title>What can you do?</title>
- 
- <p>For <em style="strong">connecting to instant messaging services</em>, use
- <em style="strong">Telepathy</em>. It provides a powerful framework for
- interacting with the user's instant messaging contacts, and has support for a
- wide range of messaging protocols. With Telepathy, all accounts and
- connections are handled by a D-Bus session service that's deeply integrated
- into GNOME. Applications can tie into this service to communicate with
- contacts.</p>
+<p>For connecting to instant messaging services, use <link xref="tech-telepathy">Telepathy</link>. It 
provides a powerful framework for interacting with the user's instant messaging contacts, and has support for 
a wide range of messaging protocols. With Telepathy, all accounts and connections are handled by an 
integrated D-Bus session service. Applications can tie into this service to communicate with contacts.</p>
   
- <p>Create multi-player games or collaborative editors that integrate with the
- desktop-wide instant messaging services. With the <em style="strong"
- xref="tech-telepathy">Telepathy Tubes</em> API, you can <em
- style="strong">tunnel an arbitrary protocol</em> over modern instant messaging
- protocols like Jabber to create interactive applications.</p>
-
- <p>Allow users to see other people they can chat with, and find printers, shared files, and shared
- music collections as soon as they connect to a network. The <em style="strong" xref="tech-avahi">Avahi</em>
- API provides <em style="strong">service discovery</em> on a local network via the mDNS/DNS-SD
- protocol suite. It's compatible with similar technology found in MacOS X and Windows.</p>
+<p>You can create multi-player games or collaborative editors that integrate with the desktop-wide instant 
messaging services. With the <link xref="tech-telepathy">Telepathy Tubes</link> API, you can tunnel an 
arbitrary protocol over modern instant messaging protocols like Jabber to create interactive applications.</p>
 
- <p>Handle users' local and online address books and calendars with <em style="strong" 
xref="tech-eds">Evolution
- Data Server</em> (EDS). It provides a way of storing account information and interacting with... </p>
+<p><link xref="tech-avahi">Avahi</link> provides service discovery on a local network via the mDNS/DNS-SD 
protocol suite, and is compatible with similar technology found in MacOS X and Windows. You can use it to 
allow users to see people they can chat with, and to find printers, shared files, and media collections.</p>
 
- <p>With <em style="strong" xref="tech-folks">Folks</em>, you will have access to a single API for
- handling social networking, chat, email, and audio/video communications. </p>
- 
-</section>
+<p>Users' address books and calendars can be handled with <link xref="tech-eds">Evolution Data Server</link> 
(EDS). Address books and calenders can be either local or online. <link xref="tech-folks">Folks</link> 
provides a single API for handling social networking, chat, email, and audio/video communications.</p>
 
 <!--<section id="samples">
  <title>Code samples</title>