[gnome-devel-docs] new-platform-overview: Markup and links tweaks

[Shaun McCance <shaunm src gnome org>]

commit 58ac2eeabde72053b71c9940922f11965c6f0a6b
Author: Shaun McCance <shaunm gnome org>
Date:   Mon Mar 19 19:28:37 2012 -0400

    new-platform-overview: Markup and links tweaks

 new-platform-overview/index.page                  |    9 +++++++
 new-platform-overview/overview-communication.page |   26 ++++++++++++++++-----
 new-platform-overview/tech-eds.page               |    4 ++-
 new-platform-overview/tech-telepathy.page         |    3 +-
 4 files changed, 34 insertions(+), 8 deletions(-)
---
diff --git a/new-platform-overview/index.page b/new-platform-overview/index.page
index ce8950c..1fa4386 100644
--- a/new-platform-overview/index.page
+++ b/new-platform-overview/index.page
@@ -39,11 +39,17 @@ can find a high-level overview of the platform, designed to introduce you to
 its capabilities, and to help you find resources on developing with GNOME.</p>
 
 <section id="overview" style="2column">
+ <info>
+  <title type="link" role="trail">Overview</title>
+ </info>
  <title>Overview of GNOME technologies</title>
  <p>Find out what you can do with GNOME's extensive collection of libraries.</p>
 </section>
 
 <section id="dev" style="2column">
+ <info>
+  <title type="link" role="trail">Tools</title>
+ </info>
  <title>Tools for developers</title>
  <p>A range of tools are available to make your life easier when developing 
  with GNOME.</p>
@@ -55,6 +61,9 @@ its capabilities, and to help you find resources on developing with GNOME.</p>
 </section>
 
 <section id="concepts" style="2column">
+ <info>
+  <title type="link" role="trail">Concepts</title>
+ </info>
  <title>Conceptual foundations</title>
  <p>Learn about some of the concepts that differentiate GNOME from other 
  development platforms.</p>
diff --git a/new-platform-overview/overview-communication.page b/new-platform-overview/overview-communication.page
index 2df4462..708b5fc 100644
--- a/new-platform-overview/overview-communication.page
+++ b/new-platform-overview/overview-communication.page
@@ -1,5 +1,5 @@
 <page xmlns="http://projectmallard.org/1.0/";
-      type="guide" style="task"
+      type="topic" style="overview"
       id="overview-communication">
   <info>
     <revision version="0.1" date="2012-02-19" status="stub"/>
@@ -11,6 +11,7 @@
       <years>2012</years>
     </credit>
 
+    <title type="link" role="trail">Communication</title>
     <desc>Instant messaging, networking, social media, email, and calendaring support.</desc>
   </info>
 
@@ -37,15 +38,28 @@
 <section id="what">
  <title>What can you do?</title>
  
- <p>For <em style="strong">connecting to instant messaging services</em>, use <em style="strong"><link xref="telepathy">Telepathy</link></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 <link xref="d-bus">D-Bus</link> session service that's deeply integrated into GNOME. Applications can tie into this service to communicate with contacts.</p>
+ <p>For <em style="strong">connecting to instant messaging services</em>, use <em style="strong"
+ xref="tech-telepathy">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 <link xref="tech-dbus">D-Bus</link>
+ session service that's deeply integrated into GNOME. 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"><link xref="telepathy#tubes">Telepathy Tubes</link></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>Create multi-player games or collaborative editors that integrate with the desktop-wide instant
+ messaging services. With the <em style="strong" xref="tech-telepathy#tubes">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"><link xref="avahi">Avahi</link></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>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>Handle users' local and online address books and calendars with <em style="strong"><link xref="eds">Evolution Data Server</link></em> (EDS). It provides a way of storing account information and interacting with </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>With <em style="strong"><link xref="eds">Folks</link></em>, you will have access to a single API for handling social networking, chat, email, and audio/video communications. </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>
 
diff --git a/new-platform-overview/tech-eds.page b/new-platform-overview/tech-eds.page
index fc3e267..e362171 100644
--- a/new-platform-overview/tech-eds.page
+++ b/new-platform-overview/tech-eds.page
@@ -1,8 +1,10 @@
 <page xmlns="http://projectmallard.org/1.0/";
-      type="topic"
+      type="topic" style="technology"
       id="tech-eds">
 <info>
   <link type="guide" xref="tech" group="apps"/>
+  <link type="guide" xref="overview-communication"/>
+
   <desc>Integration with the desktop-wide address book and calendar</desc>
   <revision pkgversion="3.0" date="2011-04-05" status="candidate"/>
 </info>
diff --git a/new-platform-overview/tech-telepathy.page b/new-platform-overview/tech-telepathy.page
index fda331c..f64d6bd 100644
--- a/new-platform-overview/tech-telepathy.page
+++ b/new-platform-overview/tech-telepathy.page
@@ -3,7 +3,8 @@
       id="tech-telepathy">
 <info>
   <link type="guide" xref="tech" group="apps"/>
-  
+  <link type="guide" xref="overview-communication"/>
+
   <desc>Unified and integrated contacts and instant messaging</desc>
   <revision pkgversion="3.0" date="2011-04-05" status="incomplete"/>
 </info>