GNOME.org
 

[gnome-devel-docs/dx-hackfest] Move all the library description pages over from the old platform overview

commit e01d89c762dc40c2574e26341f3e2d5fc579ecf2
Author: Federico Mena Quintero <federico gnome org>
Date:   Thu May 23 12:43:32 2013 -0500

    Move all the library description pages over from the old platform overview
    
    Renamed library.page to tech-library.page throughout, and fixed the xref attributes
    to link to the tech page.
    
    Signed-off-by: Federico Mena Quintero <federico gnome org>

 new-platform-overview/tech-atk.page                |  109 ++++-----------
 .../tech-avahi.page                                |    2 +-
 new-platform-overview/tech-cairo.page              |   84 ++----------
 new-platform-overview/tech-canberra.page           |   66 +--------
 .../tech-champlain.page                            |    2 +-
 new-platform-overview/tech-clutter.page            |   87 +++---------
 .../tech-d-bus.page                                |    2 +-
 new-platform-overview/tech-dbus.page               |  110 --------------
 new-platform-overview/tech-eds.page                |   70 +---------
 .../tech-enchant.page                              |    2 +-
 .../tech-folks.page                                |    2 +-
 new-platform-overview/tech-gda.page                |   83 ++---------
 new-platform-overview/tech-gdk.page                |   92 +++---------
 .../tech-geocode-glib.page                         |    2 +-
 new-platform-overview/tech-gio-network.page        |   76 +---------
 new-platform-overview/tech-gio.page                |   70 +---------
 new-platform-overview/tech-glib.page               |   78 +++--------
 new-platform-overview/tech-gobject.page            |   99 +++++--------
 new-platform-overview/tech-gsettings.page          |   90 +++++--------
 new-platform-overview/tech-gstreamer.page          |   79 ++---------
 new-platform-overview/tech-gtk.page                |  102 +++-----------
 new-platform-overview/tech-gupnp.page              |  149 +++-----------------
 .../tech-help.page                                 |    2 +-
 new-platform-overview/tech-keyring.page            |  116 ---------------
 .../tech-network-manager.page                      |    2 +-
 new-platform-overview/tech-notify.page             |   86 +++---------
 .../tech-packagekit.page                           |    2 +-
 new-platform-overview/tech-pango.page              |   75 ++---------
 .../tech-polkit.page                               |    2 +-
 .../tech-poppler.page                              |    2 +-
 .../tech-pulseaudio.page                           |    2 +-
 .../tech-secret.page                               |    2 +-
 new-platform-overview/tech-soup.page               |   85 ++++--------
 new-platform-overview/tech-telepathy.page          |   93 ++-----------
 new-platform-overview/tech-tracker.page            |   99 +++++---------
 new-platform-overview/tech-webkit.page             |   69 +---------
 platform-overview/C/atk.page                       |   58 --------
 platform-overview/C/cairo.page                     |   40 ------
 platform-overview/C/canberra.page                  |   22 ---
 platform-overview/C/clutter.page                   |   52 -------
 platform-overview/C/eds.page                       |   36 -----
 platform-overview/C/gda.page                       |   26 ----
 platform-overview/C/gdk.page                       |   53 -------
 platform-overview/C/gio-network.page               |   24 ---
 platform-overview/C/gio.page                       |   32 ----
 platform-overview/C/glib.page                      |   27 ----
 platform-overview/C/gobject.page                   |   48 -------
 platform-overview/C/gsettings.page                 |   44 ------
 platform-overview/C/gstreamer.page                 |   54 -------
 platform-overview/C/gtk.page                       |   44 ------
 platform-overview/C/gupnp.page                     |   35 -----
 platform-overview/C/notify.page                    |   27 ----
 platform-overview/C/pango.page                     |   53 -------
 platform-overview/C/soup.page                      |   35 -----
 platform-overview/C/telepathy.page                 |   30 ----
 platform-overview/C/tracker.page                   |   42 ------
 platform-overview/C/webkit.page                    |   29 ----
 57 files changed, 370 insertions(+), 2534 deletions(-)
---
diff --git a/new-platform-overview/tech-atk.page b/new-platform-overview/tech-atk.page
index e81f75f..923bdc7 100644
--- a/new-platform-overview/tech-atk.page
+++ b/new-platform-overview/tech-atk.page
@@ -1,89 +1,39 @@
 <page xmlns="http://projectmallard.org/1.0/";
       type="topic"
-      id="tech-atk">
+      id="atk">
 <info>
   <link type="guide" xref="tech" group="atk"/>
-  <desc>Support for screen readers and other accessibility
-  tools</desc>
+  <desc>Accessibility toolkit to implement support for screen readers and other tools</desc>
   <revision pkgversion="3.0" date="2011-04-05" status="candidate"/>
 </info>
 
 <title>ATK</title>
 
-<list>
- <item>
-  <p><em style="strong">Strong selling point #1</em></p>
- </item>
- <item>
-  <p><em style="strong">Strong selling point #2</em></p>
- </item>
- <item>
-  <p><em style="strong">Strong selling point #3</em></p>
- </item>
-</list>
-
-<p>Marketing blurb, info on what this library offers developers.</p>
-
-<media type="image" mime="image/png" src="test_comm1.png" width="65%">
- <p>Example image</p>
-</media>
-
-
-<section id="what">
- <title>What can you do?</title>
- 
- <p>Things that <em style="strong">you can do</em> with <em style="strong"><link xref="blah">some 
feature</link></em> of the library.</p>
-</section>
-
-
-<section id="docs">
- <title>API and reference documentation</title>
- <p></p>
- <list>
-  <item>
-   <p><em style="strong"><link href="">Documentation Link</link></em></p>
-   <p>Brief description of the documentation. Maybe also some direct links to particularly interesting 
pages.</p>
-  </item>
- </list>
-</section>
-
-
-<section id="samples">
- <title>Code samples</title>
- <list>
-  <item><p>A sample we should write</p></item>
-  <item><p><link xref="samples">More...</link></p></item>
- </list>
-</section>
-
-<section id="realworld">
- <title>Real-world examples</title>
- 
- <p>This library is used in lots of open source software. Take a look at some of it.</p>
- <list>
-  <item>
-   <p><em style="strong">XXX</em> is .</p>
-   <p>(<link href="xxx">Website</link> | <link href="xxx">Screenshot</link> | <link href="xxx">Source 
code</link> )</p>
-  </item>
- </list>
-</section>
-
-<!--
 <p>Accessibility is the process of ensuring your application can be
 used by people with various disabilities.  Disabilities come in many forms:
 visual impairments, movement impairments, hearing impairments, cognitive
 and language impairments, and seizure disorders.  Many people have some
-sort of disability, and making your application accessibility will allow
-more people to use your application effectively.</p>
-
-<p>GNOME provides support for accessibility devices using the ATK
-framework.  This framework defines a set of interfaces to which graphical
-interface components adhere.  This allows, for instance, screen readers
-to read the text of an interface and interact with its controls.  ATK
-support is built into GTK+ and the rest of the GNOME platform, so any
-application using GTK+ will have reasonable accessibility support for
+sort of disability, and making your application accessible will allow
+more people to use it effectively, even if they are not disabled.</p>
+
+<p>GNOME provides support for accessibility devices using the ATK framework,
+which stands for Accessibility Tool Kit.  This framework defines a set of
+interfaces to which graphical interface components adhere.  This allows, for
+instance, screen readers to read the text of an interface and interact with its
+controls.  ATK support is built into GTK+ and the rest of the GNOME platform,
+so any application using GTK+ will have reasonable accessibility support for
 free.</p>
 
+<p>ATK solves the problem of plugging many different kinds of widgets (text
+entries, text areas, buttons, menus) with many different types of accessibility
+technologies (screen readers, braille displays, sip-and-puff control devices).
+Instead of writing NxM interfaces, from each widget to each accessibility
+device, one just has to expose a widget through ATK's interfaces.
+Accessibility devices will in turn use these interfaces to query accessible
+widgets.  For example, an aural screen reader and a braille display will both
+use a standard "get the text contents" interface in ATK for all widgets with
+textual information.</p>
+
 <p>Nonetheless, you should be aware of accessibility issues when
 when developing your applications.  Although GTK+ interfaces provide
 reasonable accessibility by default, you can often improve how well
@@ -91,19 +41,18 @@ your program behaves with accessibility tools by providing additional
 information to ATK.  If you develop custom widgets, you should ensure
 that they expose their properties to ATK.  You should also avoid using
 sound, graphics, or color as the sole means of conveying information
-to the user.</p>
+to the user; have redundant ways of providing this information instead of
+relying on the user being to perceive a particular medium.</p>
 
-<p>The GNOME desktop ships with a number of accessibility tools
-which enable users with disabilities to take full advantage of their
-desktop and applications.  Applications that fully implement ATK will
-be able to work with the accessibility tools.  GNOME's accessibility
-tools include a screen reader, a screen magnifier, an on-screen
-keyboard, and <app>Dasher</app>, an innovative
-predictive text entry tool.</p>
+<p>The GNOME desktop ships with a number of accessibility tools which enable
+users with disabilities to take full advantage of their desktop and
+applications.  Applications that fully implement ATK will be able to work with
+the accessibility tools.  These include a screen reader, a screen magnifier, an
+on-screen keyboard, and <app>Dasher</app>, an innovative predictive text entry
+tool.</p>
 
 <list style="compact">
   <item><p><link href="http://developer.gnome.org/accessibility-devel-guide/";>GNOME Accessibility for 
Developers</link></p></item>
   <item><p><link href="http://library.gnome.org/devel/atk/stable/";>ATK Reference</link></p></item>
 </list>
--->
 </page>
diff --git a/platform-overview/C/avahi.page b/new-platform-overview/tech-avahi.page
similarity index 96%
rename from platform-overview/C/avahi.page
rename to new-platform-overview/tech-avahi.page
index 63b1680..cb5f014 100644
--- a/platform-overview/C/avahi.page
+++ b/new-platform-overview/tech-avahi.page
@@ -2,7 +2,7 @@
       type="topic"
       id="avahi">
 <info>
-  <link type="guide" xref="index" group="avahi"/>
+  <link type="guide" xref="tech" group="avahi"/>
   <desc>Zeroconf service discovery on local networks</desc>
 </info>
 
diff --git a/new-platform-overview/tech-cairo.page b/new-platform-overview/tech-cairo.page
index b014b13..675c6ed 100644
--- a/new-platform-overview/tech-cairo.page
+++ b/new-platform-overview/tech-cairo.page
@@ -1,100 +1,40 @@
 <page xmlns="http://projectmallard.org/1.0/";
       type="topic"
-      id="tech-cairo">
+      id="cairo">
 <info>
   <link type="guide" xref="tech" group="cairo"/>
-  
-  <desc>Modern 2D vector drawing canvas</desc>
+  <desc>2D, vector-based drawing for high-quality graphics</desc>
   <revision pkgversion="3.0" date="2011-04-05" status="candidate"/>
 </info>
 
 <title>Cairo</title>
 
-<list>
- <item>
-  <p><em style="strong">Strong selling point #1</em></p>
- </item>
- <item>
-  <p><em style="strong">Strong selling point #2</em></p>
- </item>
- <item>
-  <p><em style="strong">Strong selling point #3</em></p>
- </item>
-</list>
-
-<p>Marketing blurb, info on what this library offers developers.</p>
-
-<media type="image" mime="image/png" src="test_comm1.png" width="65%">
- <p>Example image</p>
-</media>
-
-
-<section id="what">
- <title>What can you do?</title>
- 
- <p>Things that <em style="strong">you can do</em> with <em style="strong"><link xref="blah">some 
feature</link></em> of the library.</p>
-</section>
-
-
-<section id="docs">
- <title>API and reference documentation</title>
- <p></p>
- <list>
-  <item>
-   <p><em style="strong"><link href="">Documentation Link</link></em></p>
-   <p>Brief description of the documentation. Maybe also some direct links to particularly interesting 
pages.</p>
-  </item>
- </list>
-</section>
-
-
-<section id="samples">
- <title>Code samples</title>
- <list>
-  <item><p>A sample we should write</p></item>
-  <item><p><link xref="samples">More...</link></p></item>
- </list>
-</section>
-
-<section id="realworld">
- <title>Real-world examples</title>
- 
- <p>This library is used in lots of open source software. Take a look at some of it.</p>
- <list>
-  <item>
-   <p><em style="strong">XXX</em> is .</p>
-   <p>(<link href="xxx">Website</link> | <link href="xxx">Screenshot</link> | <link href="xxx">Source 
code</link> )</p>
-  </item>
- </list>
-</section>
-
-<!--
 <p>Cairo is a 2D graphics library featuring a sophisticated API for
-drawing vector graphics, compositing images, and rendering anti-aliased
-text.  Cairo provides support for multiple output devices, including the
-X Window System, Microsoft Windows, and image buffers, allowing you to
-write platform-independent code to draw graphics on different media.</p>
+drawing vector graphics, compositing images, and rendering
+anti-aliased text.  Cairo provides support for multiple output
+devices, including the X Window System, Microsoft Windows, and image
+buffers in memory, allowing you to write platform-independent code to
+draw graphics on different media.</p>
 
-<p>The Cairo drawing model is similar to those provided by PostScript
+<p>Cairo's drawing model is similar to those provided by PostScript
 and PDF.  The Cairo API provides such drawing operations as stroking and
 filling cubic Bézier splines, compositing images, and performing affine
 transformations.  These vector operations allow for rich, anti-aliased
-graphics without using expensive pixel-based drawing in your application
-code.</p>
+graphics.</p>
 
 <p>Cairo's rich drawing model allows for high-quality rendering to
-multiple media.  The same API can be used to create stunning on-screen
+multiple media.  The same API can be used to create on-screen
 graphics and text, to render images, or create crisp output suitable
 for printing.</p>
 
 <p>You should use Cairo whenever you need to draw graphics in your
-application beyond the widgets provided by GTK+.  Much of the drawing
+application beyond the widgets provided by GTK+.  Almost all of the drawing
 inside GTK+ is done using Cairo.  Using Cairo for your custom drawing
 will allow your application to have high-quality, anti-aliased, and
 resolution-independent graphics.</p>
 
 <list style="compact">
   <item><p><link href="http://www.cairographics.org/manual/";>Cairo Manual</link></p></item>
+  <item><p><link href="http://www.cairographics.org";>The Cairo web site</link></p></item>
 </list>
--->
 </page>
diff --git a/new-platform-overview/tech-canberra.page b/new-platform-overview/tech-canberra.page
index 527b559..bcc0f67 100644
--- a/new-platform-overview/tech-canberra.page
+++ b/new-platform-overview/tech-canberra.page
@@ -1,74 +1,14 @@
 <page xmlns="http://projectmallard.org/1.0/";
       type="topic"
-      id="tech-canberra">
+      id="canberra">
 <info>
-  <link type="guide" xref="tech" group="apps"/>
-  
+  <link type="guide" xref="tech" group="canberra"/>
   <desc>Simple audio API for notifications and events</desc>
   <revision pkgversion="3.0" date="2011-04-05" status="incomplete"/>
 </info>
 
 <title>Canberra</title>
 
-<list>
- <item>
-  <p><em style="strong">Strong selling point #1</em></p>
- </item>
- <item>
-  <p><em style="strong">Strong selling point #2</em></p>
- </item>
- <item>
-  <p><em style="strong">Strong selling point #3</em></p>
- </item>
-</list>
-
-<p>Marketing blurb, info on what this library offers developers.</p>
-
-<media type="image" mime="image/png" src="test_comm1.png" width="65%">
- <p>Example image</p>
-</media>
-
-
-<section id="what">
- <title>What can you do?</title>
- 
- <p>Things that <em style="strong">you can do</em> with <em style="strong"><link xref="blah">some 
feature</link></em> of the library.</p>
-</section>
-
-
-<section id="docs">
- <title>API and reference documentation</title>
- <p></p>
- <list>
-  <item>
-   <p><em style="strong"><link href="">Documentation Link</link></em></p>
-   <p>Brief description of the documentation. Maybe also some direct links to particularly interesting 
pages.</p>
-  </item>
- </list>
-</section>
-
-
-<section id="samples">
- <title>Code samples</title>
- <list>
-  <item><p>A sample we should write</p></item>
-  <item><p><link xref="samples">More...</link></p></item>
- </list>
-</section>
-
-<section id="realworld">
- <title>Real-world examples</title>
- 
- <p>This library is used in lots of open source software. Take a look at some of it.</p>
- <list>
-  <item>
-   <p><em style="strong">XXX</em> is .</p>
-   <p>(<link href="xxx">Website</link> | <link href="xxx">Screenshot</link> | <link href="xxx">Source 
code</link> )</p>
-  </item>
- </list>
-</section>
-
-<!--
 <p>Canberra is a simple library for playing audio events and notifications,
 such as when the user has received a message or an error has occurred.
 As well as providing a convenient API, Canberra can also work with the
@@ -78,5 +18,5 @@ for hearing-impaired users.</p>
 <list style="compact">
   <item><p><link 
href="http://library.gnome.org/devel/libcanberra/unstable/libcanberra-canberra.html";>Canberra 
Reference</link></p></item>
 </list>
--->
+
 </page>
diff --git a/platform-overview/C/champlain.page b/new-platform-overview/tech-champlain.page
similarity index 93%
rename from platform-overview/C/champlain.page
rename to new-platform-overview/tech-champlain.page
index b59b121..d0e858d 100644
--- a/platform-overview/C/champlain.page
+++ b/new-platform-overview/tech-champlain.page
@@ -2,7 +2,7 @@
       type="topic"
       id="champlain">
 <info>
-  <link type="guide" xref="index" group="champlain"/>
+  <link type="guide" xref="tech" group="champlain"/>
   <desc>Map rendering</desc>
 </info>
 
diff --git a/new-platform-overview/tech-clutter.page b/new-platform-overview/tech-clutter.page
index 33e98bc..3afcb51 100644
--- a/new-platform-overview/tech-clutter.page
+++ b/new-platform-overview/tech-clutter.page
@@ -1,75 +1,18 @@
 <page xmlns="http://projectmallard.org/1.0/";
       type="topic"
-      id="tech-clutter">
+      id="clutter">
 <info>
   <link type="guide" xref="tech" group="clutter"/>
-  <desc>Stunning graphics and animations with a scene-graph API</desc>
+  <desc>Animations and scene graph</desc>
   <revision pkgversion="3.0" date="2011-04-05" status="incomplete"/>
 </info>
 
 <title>Clutter</title>
 
-<list>
- <item>
-  <p><em style="strong">Strong selling point #1</em></p>
- </item>
- <item>
-  <p><em style="strong">Strong selling point #2</em></p>
- </item>
- <item>
-  <p><em style="strong">Strong selling point #3</em></p>
- </item>
-</list>
-
-<p>Marketing blurb, info on what this library offers developers.</p>
-
-<media type="image" mime="image/png" src="test_comm1.png" width="65%">
- <p>Example image</p>
-</media>
-
-
-<section id="what">
- <title>What can you do?</title>
- 
- <p>Things that <em style="strong">you can do</em> with <em style="strong"><link xref="blah">some 
feature</link></em> of the library.</p>
-</section>
-
-
-<section id="docs">
- <title>API and reference documentation</title>
- <p></p>
- <list>
-  <item>
-   <p><em style="strong"><link href="">Documentation Link</link></em></p>
-   <p>Brief description of the documentation. Maybe also some direct links to particularly interesting 
pages.</p>
-  </item>
- </list>
-</section>
-
-
-<section id="samples">
- <title>Code samples</title>
- <list>
-  <item><p>A sample we should write</p></item>
-  <item><p><link xref="samples">More...</link></p></item>
- </list>
-</section>
-
-<section id="realworld">
- <title>Real-world examples</title>
- 
- <p>This library is used in lots of open source software. Take a look at some of it.</p>
- <list>
-  <item>
-   <p><em style="strong">XXX</em> is .</p>
-   <p>(<link href="xxx">Website</link> | <link href="xxx">Screenshot</link> | <link href="xxx">Source 
code</link> )</p>
-  </item>
- </list>
-</section>
-
-<!--
-<p>Clutter is a library that allows creating fast, portable, dynamic,
-compelling user interfaces.</p>
+<p>Clutter is a library for doing animations and using a 2.5-D canvas.
+You create graphical objects out of images, and you can manipulate
+them later to move them, rotate them, or give them quasi-3D
+effects.</p>
 
 <p>Clutter uses the <link href="http://www.khronos.org/opengl/";>OpenGL</link>
 and <link href="http://www.khronos.org/opengles/";>OpenGL|ES</link> industry
@@ -80,13 +23,19 @@ programming.</p>
 <p>Clutter does not specify any visual style, and does not provide any
 pre-defined complex user interface control; it lets the developer define what
 is needed, using a flexible scene graph API, with free-form placement of the
-scene elements (or "actors") on the main viewport (or "stage").</p>
+scene elements (or <em>actors</em>) on the main viewport (or <em>stage</em>).</p>
 
 <p>Clutter comes with pre-defined actors for displaying solid colors,
-image data, text and custom high-precision 2D drawing using the Cairo
-API. Clutter also provides generic classes for structuring a user interface
-using both a box-packing model like GTK+, and a series of free-form
-"constraints".</p>
+image data, text and custom high-precision 2D drawing using the <link
+xref="cairo">Cairo</link> API. Clutter also provides generic classes
+for structuring a user interface using both a box-packing model like
+<link xref="gtk">GTK+</link>, and a series of free-form
+<em>constraints</em>.</p>
+
+<p>Clutter provides an extensible animation framework and graphical
+effects. An animation is associated with a timeline and changes one or
+more properties of one or more actors over time, for example their
+rotation in a particular dimension, scale, size, opacity, etc.</p>
 
 <p>A number of third-party libraries allow integration with other
 technologies, such as: Clutter-GTK, for embedding a Clutter stage inside a
@@ -99,5 +48,5 @@ in both 2D and 3D environments.</p>
   <item><p><link href="http://developer.gnome.org/clutter/stable";>Clutter Reference Manual</link></p></item>
   <item><p><link href="http://www.clutter-project.org";>The Clutter web site</link></p></item>
 </list>
--->
+
 </page>
diff --git a/platform-overview/C/d-bus.page b/new-platform-overview/tech-d-bus.page
similarity index 97%
rename from platform-overview/C/d-bus.page
rename to new-platform-overview/tech-d-bus.page
index bfe29b7..6dc3776 100644
--- a/platform-overview/C/d-bus.page
+++ b/new-platform-overview/tech-d-bus.page
@@ -2,7 +2,7 @@
       type="topic"
       id="d-bus">
 <info>
-  <link type="guide" xref="index" group="d-bus"/>
+  <link type="guide" xref="tech" group="d-bus"/>
   <desc>Inter-process communication bus to provide APIs to other processes</desc>
   <revision pkgversion="3.0" date="2011-04-05" status="candidate"/>
 </info>
diff --git a/new-platform-overview/tech-eds.page b/new-platform-overview/tech-eds.page
index e362171..080c291 100644
--- a/new-platform-overview/tech-eds.page
+++ b/new-platform-overview/tech-eds.page
@@ -1,75 +1,14 @@
 <page xmlns="http://projectmallard.org/1.0/";
-      type="topic" style="technology"
-      id="tech-eds">
+      type="topic"
+      id="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>
+  <link type="guide" xref="tech" group="eds"/>
+  <desc>Desktop-wide addressbook for contacts and calendar</desc>
   <revision pkgversion="3.0" date="2011-04-05" status="candidate"/>
 </info>
 
 <title>Evolution Data Server</title>
 
-<list>
- <item>
-  <p><em style="strong">Strong selling point #1</em></p>
- </item>
- <item>
-  <p><em style="strong">Strong selling point #2</em></p>
- </item>
- <item>
-  <p><em style="strong">Strong selling point #3</em></p>
- </item>
-</list>
-
-<p>Marketing blurb, info on what this library offers developers.</p>
-
-<media type="image" mime="image/png" src="test_comm1.png" width="65%">
- <p>Example image</p>
-</media>
-
-
-<section id="what">
- <title>What can you do?</title>
- 
- <p>Things that <em style="strong">you can do</em> with <em style="strong"><link xref="blah">some 
feature</link></em> of the library.</p>
-</section>
-
-
-<section id="docs">
- <title>API and reference documentation</title>
- <p></p>
- <list>
-  <item>
-   <p><em style="strong"><link href="">Documentation Link</link></em></p>
-   <p>Brief description of the documentation. Maybe also some direct links to particularly interesting 
pages.</p>
-  </item>
- </list>
-</section>
-
-
-<section id="samples">
- <title>Code samples</title>
- <list>
-  <item><p>A sample we should write</p></item>
-  <item><p><link xref="samples">More...</link></p></item>
- </list>
-</section>
-
-<section id="realworld">
- <title>Real-world examples</title>
- 
- <p>This library is used in lots of open source software. Take a look at some of it.</p>
- <list>
-  <item>
-   <p><em style="strong">XXX</em> is .</p>
-   <p>(<link href="xxx">Website</link> | <link href="xxx">Screenshot</link> | <link href="xxx">Source 
code</link> )</p>
-  </item>
- </list>
-</section>
-
-<!--
 <p>With Evolution Data Server, GNOME provides a single address book and
 calendar that all applications can use to store and retrieve information.
 Using Evolution Data Server means that users no longer have to maintain
@@ -94,5 +33,4 @@ see upcoming appointments without opening a full calendar application.</p>
   <item><p><link href="http://developer.gnome.org/libebook/stable/";>Evolution API Reference: 
libebook</link></p></item>
   <item><p><link href="http://developer.gnome.org/libecal/stable/";>Evolution API Reference: 
libecal</link></p></item>
 </list>
--->
 </page>
diff --git a/platform-overview/C/enchant.page b/new-platform-overview/tech-enchant.page
similarity index 93%
rename from platform-overview/C/enchant.page
rename to new-platform-overview/tech-enchant.page
index c9076c8..36327e9 100644
--- a/platform-overview/C/enchant.page
+++ b/new-platform-overview/tech-enchant.page
@@ -2,7 +2,7 @@
       type="topic"
       id="enchant">
 <info>
-  <link type="guide" xref="index" group="enchant"/>
+  <link type="guide" xref="tech" group="enchant"/>
   <desc>Real-time spell checking for text widgets</desc>
 </info>
 
diff --git a/platform-overview/C/folks.page b/new-platform-overview/tech-folks.page
similarity index 96%
rename from platform-overview/C/folks.page
rename to new-platform-overview/tech-folks.page
index 6d10780..8413f54 100644
--- a/platform-overview/C/folks.page
+++ b/new-platform-overview/tech-folks.page
@@ -2,7 +2,7 @@
       type="topic"
       id="folks">
 <info>
-  <link type="guide" xref="index" group="folks"/>
+  <link type="guide" xref="tech" group="folks"/>
   <desc>Aggregate contacts from multiple local and online sources</desc>
 </info>
 
diff --git a/new-platform-overview/tech-gda.page b/new-platform-overview/tech-gda.page
index 44c92ea..ae920f6 100644
--- a/new-platform-overview/tech-gda.page
+++ b/new-platform-overview/tech-gda.page
@@ -1,79 +1,26 @@
 <page xmlns="http://projectmallard.org/1.0/";
       type="topic"
-      id="tech-gda">
+      id="gda">
 <info>
-  <link type="guide" xref="tech" group="apps"/>
-  <desc>Common relational database access</desc>
+  <link type="guide" xref="tech" group="gda"/>
+  <desc>Unified access to relational databases</desc>
   <revision pkgversion="3.0" date="2011-04-05" status="incomplete"/>
 </info>
 
-<title>GDA</title>
-
-<list>
- <item>
-  <p><em style="strong">Strong selling point #1</em></p>
- </item>
- <item>
-  <p><em style="strong">Strong selling point #2</em></p>
- </item>
- <item>
-  <p><em style="strong">Strong selling point #3</em></p>
- </item>
-</list>
-
-<p>Marketing blurb, info on what this library offers developers.</p>
-
-<media type="image" mime="image/png" src="test_comm1.png" width="65%">
- <p>Example image</p>
-</media>
-
-
-<section id="what">
- <title>What can you do?</title>
- 
- <p>Things that <em style="strong">you can do</em> with <em style="strong"><link xref="blah">some 
feature</link></em> of the library.</p>
-</section>
+<title>GNOME Data Access</title>
 
+<p>GNOME Data Access, or GDA for short, offers a wrapper around
+relational databases, which allows you to easily store and retrieve data in many
+different common database systems.</p>
 
-<section id="docs">
- <title>API and reference documentation</title>
- <p></p>
- <list>
-  <item>
-   <p><em style="strong"><link href="">Documentation Link</link></em></p>
-   <p>Brief description of the documentation. Maybe also some direct links to particularly interesting 
pages.</p>
-  </item>
- </list>
-</section>
+<p>Instead of worrying about the vagaries of different database systems, GDA
+provides a unified interface to them.  GDA supports SQLite, MySQL, PostreSQL,
+Microsoft Access, Berkeley DB, Oracle, and JDBC.</p>
+  
 
-
-<section id="samples">
- <title>Code samples</title>
- <list>
-  <item><p>A sample we should write</p></item>
-  <item><p><link xref="samples">More...</link></p></item>
- </list>
-</section>
-
-<section id="realworld">
- <title>Real-world examples</title>
- 
- <p>This library is used in lots of open source software. Take a look at some of it.</p>
- <list>
-  <item>
-   <p><em style="strong">XXX</em> is .</p>
-   <p>(<link href="xxx">Website</link> | <link href="xxx">Screenshot</link> | <link href="xxx">Source 
code</link> )</p>
-  </item>
- </list>
-</section>
-
-<!--
-<p>GDA offers a wrapper around relational databases, allowing you to
-easily store and retrieve data in many different common database
-systems.</p>
-
-<steps>
+<list style="compact">
   <item><p><link href="http://developer-next.gnome.org/libgda/stable/";>GNOME Data Access 
Manual</link></p></item>
-</steps>
--->
+  <item><p><link href="http://www.gnome-db.org/";>GDA Home Page</link></p></item>
+</list>
+
 </page>
diff --git a/new-platform-overview/tech-gdk.page b/new-platform-overview/tech-gdk.page
index 418993e..cbf241a 100644
--- a/new-platform-overview/tech-gdk.page
+++ b/new-platform-overview/tech-gdk.page
@@ -1,82 +1,32 @@
 <page xmlns="http://projectmallard.org/1.0/";
       type="topic"
-      id="tech-gdk">
+      id="gdk">
 <info>
   <link type="guide" xref="tech" group="gdk"/>
-  <desc>Underlying windowing and event handling</desc>
+  <desc>Low-level abstraction for the windowing system</desc>
   <revision pkgversion="3.0" date="2011-04-05" status="candidate"/>
 </info>
 
 <title>GDK</title>
 
-<list>
- <item>
-  <p><em style="strong">Strong selling point #1</em></p>
- </item>
- <item>
-  <p><em style="strong">Strong selling point #2</em></p>
- </item>
- <item>
-  <p><em style="strong">Strong selling point #3</em></p>
- </item>
-</list>
-
-<p>Marketing blurb, info on what this library offers developers.</p>
-
-<media type="image" mime="image/png" src="test_comm1.png" width="65%">
- <p>Example image</p>
-</media>
-
-
-<section id="what">
- <title>What can you do?</title>
- 
- <p>Things that <em style="strong">you can do</em> with <em style="strong"><link xref="blah">some 
feature</link></em> of the library.</p>
-</section>
-
-
-<section id="docs">
- <title>API and reference documentation</title>
- <p></p>
- <list>
-  <item>
-   <p><em style="strong"><link href="">Documentation Link</link></em></p>
-   <p>Brief description of the documentation. Maybe also some direct links to particularly interesting 
pages.</p>
-  </item>
- </list>
-</section>
-
-
-<section id="samples">
- <title>Code samples</title>
- <list>
-  <item><p>A sample we should write</p></item>
-  <item><p><link xref="samples">More...</link></p></item>
- </list>
-</section>
-
-<section id="realworld">
- <title>Real-world examples</title>
- 
- <p>This library is used in lots of open source software. Take a look at some of it.</p>
- <list>
-  <item>
-   <p><em style="strong">XXX</em> is .</p>
-   <p>(<link href="xxx">Website</link> | <link href="xxx">Screenshot</link> | <link href="xxx">Source 
code</link> )</p>
-  </item>
- </list>
-</section>
-
-<!--
-<p>GDK is the low-level library used by GTK+ to interact with the
-system for graphics and input devices.  Although you will rarely use
+<p>GDK is the low-level library used by <link xref="gtk">GTK+</link> to interact with the
+windowing system for graphics and input devices.  Although you will rarely use
 GDK directly in application code, it contains all the necessary
-functionality to draw objects and text to the screen and to interact
-with the user with various input devices.</p>
+functionality to create low-level windows in the the screen and to interact
+with the user with various input devices.  GDK acts as an abstraction over
+various windowing systems, so that GTK+ can be portable to all of them:
+the X Window System (X11), Microsoft Windows, Mac OS X Quartz.</p>
 
 <p>GDK enables you to access events from keyboards, mice, and other
-input devices, rather than connect to the high-level signals used in
-GTK+.  GDK also provides low-level routines to access drag and drop
+input devices.  Implementations of widgets in GTK+ use this functionality, and
+translate the events into higher-level signals that can in turn be used from
+application code.  For example, a <code>GtkButton</code> widget will track
+<code>GDK_BUTTON_PRESS</code> and <code>GTK_BUTTON_RELEASE</code> events,
+which come from the mouse, and translate them as appropriate into a
+<code>GtkButton::clicked</code> signal when the user presses and releases
+the button in the right location.</p>
+
+<p>GDK also provides low-level routines to access drag and drop
 and clipboard data from the system.  When implementing custom controls,
 you may need to access these features to implement proper user interaction
 behavior.</p>
@@ -92,12 +42,12 @@ color depth, colormaps, and cursors.</p>
 underlying windowing system, including low-level access to events,
 windows, and the clipboard.  Using GDK for these tasks ensures that
 your code is portable and integrates with the rest of your GTK+ code.
-The simple drawing routines in GDK should generally not be used.
-Instead, you should use the extensive functionality provide by
-Cairo.</p>
+The simple drawing routines in GDK should generally not be used; these are a
+left-over from when GDK simply wrapped the windowing system's drawing primitives.
+Instead, you should use the extensive functionality provided by
+<link xref="cairo">Cairo</link> to draw high-quality 2D graphics.</p>
 
 <list style="compact">
   <item><p><link href="http://library.gnome.org/devel/gdk/stable/";>GDK Reference Manual</link></p></item>
 </list>
--->
 </page>
diff --git a/platform-overview/C/geocode-glib.page b/new-platform-overview/tech-geocode-glib.page
similarity index 92%
rename from platform-overview/C/geocode-glib.page
rename to new-platform-overview/tech-geocode-glib.page
index 87dcb36..7ae27cb 100644
--- a/platform-overview/C/geocode-glib.page
+++ b/new-platform-overview/tech-geocode-glib.page
@@ -2,7 +2,7 @@
       type="topic"
       id="geocode-glib">
 <info>
-  <link type="guide" xref="index" group="geocode-glib"/>
+  <link type="guide" xref="tech" group="geocode-glib"/>
   <desc>Geocoding and reverse geocoding</desc>
 </info>
 
diff --git a/new-platform-overview/tech-gio-network.page b/new-platform-overview/tech-gio-network.page
index 63f9c0e..61eeb06 100644
--- a/new-platform-overview/tech-gio-network.page
+++ b/new-platform-overview/tech-gio-network.page
@@ -1,84 +1,24 @@
 <page xmlns="http://projectmallard.org/1.0/";
       type="topic"
-      id="tech-gio-network">
+      id="gio-network">
 <info>
   <link type="guide" xref="tech" group="gio-network"/>
-  <desc>Powerful networking API built on the GIO stream classes</desc>
+  <desc>Networking and sockets API with streams</desc>
   <revision pkgversion="3.0" date="2011-04-05" status="review"/>
 </info>
 
 <title>GIO Networking</title>
 
-<list>
- <item>
-  <p><em style="strong">Strong selling point #1</em></p>
- </item>
- <item>
-  <p><em style="strong">Strong selling point #2</em></p>
- </item>
- <item>
-  <p><em style="strong">Strong selling point #3</em></p>
- </item>
-</list>
-
-<p>Marketing blurb, info on what this library offers developers.</p>
-
-<media type="image" mime="image/png" src="test_comm1.png" width="65%">
- <p>Example image</p>
-</media>
-
-
-<section id="what">
- <title>What can you do?</title>
- 
- <p>Things that <em style="strong">you can do</em> with <em style="strong"><link xref="blah">some 
feature</link></em> of the library.</p>
-</section>
-
-
-<section id="docs">
- <title>API and reference documentation</title>
- <p></p>
- <list>
-  <item>
-   <p><em style="strong"><link href="">Documentation Link</link></em></p>
-   <p>Brief description of the documentation. Maybe also some direct links to particularly interesting 
pages.</p>
-  </item>
- </list>
-</section>
-
-
-<section id="samples">
- <title>Code samples</title>
- <list>
-  <item><p>A sample we should write</p></item>
-  <item><p><link xref="samples">More...</link></p></item>
- </list>
-</section>
-
-<section id="realworld">
- <title>Real-world examples</title>
- 
- <p>This library is used in lots of open source software. Take a look at some of it.</p>
- <list>
-  <item>
-   <p><em style="strong">XXX</em> is .</p>
-   <p>(<link href="xxx">Website</link> | <link href="xxx">Screenshot</link> | <link href="xxx">Source 
code</link> )</p>
-  </item>
- </list>
-</section>
-
-<!--
-<p>Built on top of the stream APIs used for files, GIO provides
-high-level networking APIs to communicate over TCP/IP and UNIX
-domain sockets. You can use the GIO networking APIs to connect
-to a server, listen for events, and read resources. The
-asynchronous API designs means your application doesn't block
-waiting for a response.</p>
+<p>GIO Networking is built on top of the stream APIs <link xref="gio">used for
+files</link>.  It provides high-level APIs to communicate over TCP/IP and UNIX
+domain sockets. You can use the GIO networking APIs to connect to a server,
+listen for events, and read resources. The asynchronous API means your
+application doesn't block waiting for a response from the network.</p>
 
 <list style="compact">
   <item><p><link href="http://developer.gnome.org/gio/stable/";>GIO Reference Manual</link></p></item>
   <item><p><link href="http://developer-next.gnome.org/gio/stable/networking.html";>Lowlevel network 
support</link></p></item>
   <item><p><link href="http://developer-next.gnome.org/gio/stable/highlevel-socket.html";>Highlevel network 
functionality</link></p></item>
 </list>
--->
+
 </page>
diff --git a/new-platform-overview/tech-gio.page b/new-platform-overview/tech-gio.page
index 0321354..afe8482 100644
--- a/new-platform-overview/tech-gio.page
+++ b/new-platform-overview/tech-gio.page
@@ -1,78 +1,18 @@
 <page xmlns="http://projectmallard.org/1.0/";
       type="topic"
-      id="tech-gio">
+      id="gio">
 <info>
   <link type="guide" xref="tech" group="gio"/>
-  <desc>Asynchronous file and URI handling with access
-  to file and volume info</desc>
+  <desc>File and URI handling, asynchronous file operations, volume handling</desc>
   <revision pkgversion="3.0" date="2011-04-05" status="review"/>
 </info>
 
 <title>GIO Files</title>
 
-<list>
- <item>
-  <p><em style="strong">Strong selling point #1</em></p>
- </item>
- <item>
-  <p><em style="strong">Strong selling point #2</em></p>
- </item>
- <item>
-  <p><em style="strong">Strong selling point #3</em></p>
- </item>
-</list>
-
-<p>Marketing blurb, info on what this library offers developers.</p>
-
-<media type="image" mime="image/png" src="test_comm1.png" width="65%">
- <p>Example image</p>
-</media>
-
-
-<section id="what">
- <title>What can you do?</title>
- 
- <p>Things that <em style="strong">you can do</em> with <em style="strong"><link xref="blah">some 
feature</link></em> of the library.</p>
-</section>
-
-
-<section id="docs">
- <title>API and reference documentation</title>
- <p></p>
- <list>
-  <item>
-   <p><em style="strong"><link href="">Documentation Link</link></em></p>
-   <p>Brief description of the documentation. Maybe also some direct links to particularly interesting 
pages.</p>
-  </item>
- </list>
-</section>
-
-
-<section id="samples">
- <title>Code samples</title>
- <list>
-  <item><p>A sample we should write</p></item>
-  <item><p><link xref="samples">More...</link></p></item>
- </list>
-</section>
-
-<section id="realworld">
- <title>Real-world examples</title>
- 
- <p>This library is used in lots of open source software. Take a look at some of it.</p>
- <list>
-  <item>
-   <p><em style="strong">XXX</em> is .</p>
-   <p>(<link href="xxx">Website</link> | <link href="xxx">Screenshot</link> | <link href="xxx">Source 
code</link> )</p>
-  </item>
- </list>
-</section>
-
-<!--
 <p>GIO provides APIs for asynchronously reading and writing files and
-other streams. Files are referenced by URIs, and local backends can
+other streams. Files are referenced by URIs (uniform resource locators), and backends can
 provide access to more than just local files. When running under the
-GNOME desktop, GIO uses GVfs to allow access to files over SFTP, FTP,
+GNOME desktop, GIO uses GVFS to allow access to files over SFTP, FTP,
 WebDAV, SMB, and other popular protocols. This transparent network
 file access is free to all applications using GIO.</p>
 
@@ -88,5 +28,5 @@ file types and icons, and finding applications to open files.</p>
 <list style="compact">
   <item><p><link href="http://developer.gnome.org/gio/stable/";>GIO Reference Manual</link></p></item>
 </list>
--->
+
 </page>
diff --git a/new-platform-overview/tech-glib.page b/new-platform-overview/tech-glib.page
index 80c7d4d..211f6a0 100644
--- a/new-platform-overview/tech-glib.page
+++ b/new-platform-overview/tech-glib.page
@@ -1,69 +1,27 @@
 <page xmlns="http://projectmallard.org/1.0/";
-      type="topic" id="glib">
+      type="topic"
+      id="glib">
 <info>
   <link type="guide" xref="tech" group="glib"/>
-  <desc>glib</desc>
+  <desc>Data structures and utilities for C programs</desc>
 </info>
 
 <title>GLib</title>
 
-<list>
- <item>
-  <p><em style="strong">Strong selling point #1</em></p>
- </item>
- <item>
-  <p><em style="strong">Strong selling point #2</em></p>
- </item>
- <item>
-  <p><em style="strong">Strong selling point #3</em></p>
- </item>
-</list>
-
-<p>Marketing blurb, info on what this library offers developers.</p>
-
-<media type="image" mime="image/png" src="test_comm1.png" width="65%">
- <p>Example image</p>
-</media>
-
-
-<section id="what">
- <title>What can you do?</title>
- 
- <p>Things that <em style="strong">you can do</em> with <em style="strong"><link xref="blah">some 
feature</link></em> of the library.</p>
-</section>
-
-
-<section id="docs">
- <title>API and reference documentation</title>
- <p></p>
- <list>
-  <item>
-   <p><em style="strong"><link href="">Documentation Link</link></em></p>
-   <p>Brief description of the documentation. Maybe also some direct links to particularly interesting 
pages.</p>
-  </item>
- </list>
-</section>
-
-
-<section id="samples">
- <title>Code samples</title>
- <list>
-  <item><p>A sample we should write</p></item>
-  <item><p><link xref="samples">More...</link></p></item>
- </list>
-</section>
-
-<section id="realworld">
- <title>Real-world examples</title>
- 
- <p>This library is used in lots of open source software. Take a look at some of it.</p>
- <list>
-  <item>
-   <p><em style="strong">XXX</em> is .</p>
-   <p>(<link href="xxx">Website</link> | <link href="xxx">Screenshot</link> | <link href="xxx">Source 
code</link> )</p>
-  </item>
- </list>
-</section>
-
+  <p>
+    GLib is the most fundamental of all the GNOME libraries.  It provides
+    simple data structures for C programs (linked lists, binary trees, hash
+    tables) and various utilities such as string manipulation functions.
+  </p>
+
+  <p>
+    If you are not writing C programs, you normally don't need to be concerned
+    with GLib.  If you are, however, GLib will make your life as a C programmer
+    much easier.
+  </p>
+
+  <list style="compact">
+    <item><p><link href="http://developer.gnome.org/glib/stable/";>GLib reference manual</link></p></item>
+  </list>
 
 </page>
diff --git a/new-platform-overview/tech-gobject.page b/new-platform-overview/tech-gobject.page
index 3539050..9d24030 100644
--- a/new-platform-overview/tech-gobject.page
+++ b/new-platform-overview/tech-gobject.page
@@ -1,69 +1,48 @@
 <page xmlns="http://projectmallard.org/1.0/";
-      type="topic" id="tech-gobject">
+      type="topic"
+      id="gobject">
 <info>
   <link type="guide" xref="tech" group="gobject"/>
-  <desc>Bindable and introspectable C object system</desc>
+  <desc>C-based object and type system with signals and slots</desc>
 </info>
 
 <title>GObject</title>
 
-<list>
- <item>
-  <p><em style="strong">Strong selling point #1</em></p>
- </item>
- <item>
-  <p><em style="strong">Strong selling point #2</em></p>
- </item>
- <item>
-  <p><em style="strong">Strong selling point #3</em></p>
- </item>
-</list>
-
-<p>Marketing blurb, info on what this library offers developers.</p>
-
-<media type="image" mime="image/png" src="test_comm1.png" width="65%">
- <p>Example image</p>
-</media>
-
-
-<section id="what">
- <title>What can you do?</title>
- 
- <p>Things that <em style="strong">you can do</em> with <em style="strong"><link xref="blah">some 
feature</link></em> of the library.</p>
-</section>
-
-
-<section id="docs">
- <title>API and reference documentation</title>
- <p></p>
- <list>
-  <item>
-   <p><em style="strong"><link href="">Documentation Link</link></em></p>
-   <p>Brief description of the documentation. Maybe also some direct links to particularly interesting 
pages.</p>
-  </item>
- </list>
-</section>
-
-
-<section id="samples">
- <title>Code samples</title>
- <list>
-  <item><p>A sample we should write</p></item>
-  <item><p><link xref="samples">More...</link></p></item>
- </list>
-</section>
-
-<section id="realworld">
- <title>Real-world examples</title>
- 
- <p>This library is used in lots of open source software. Take a look at some of it.</p>
- <list>
-  <item>
-   <p><em style="strong">XXX</em> is .</p>
-   <p>(<link href="xxx">Website</link> | <link href="xxx">Screenshot</link> | <link href="xxx">Source 
code</link> )</p>
-  </item>
- </list>
-</section>
-
+  <p>
+    GObject is the part of the <link xref="glib">GLib</link> library that
+    provides an object and type system for C programs.  Although C as a
+    language does not provide objects or classes, GObject makes it possible to
+    write object-oriented C programs.
+  </p>
+
+  <p>
+    GObject provides a fundamental GType, the base for the whole type system,
+    from which types such as ints and strings are derived.  Then, there is
+    GObject itself, the base class for all other classes.  Objects can emit
+    <em>signals</em> to notify the caller when something interesting happens.
+    For example, a <code>Button</code> object could emit a <code>clicked</code>
+    signal to indicate that it has been pressed and released.
+  </p>
+
+  <p>
+    GObject is <em>introspectible</em>, which means that you can ask the
+    GObject system for the class types that are defined, the methods they
+    support, their signals, etc.  GNOME's language bindings are built on top of
+    this introspection information.  Instead of writing wrappers by hand to let
+    GNOME APIs be called from other programming languages, language bindings
+    use the introspection information from GObject to auto-generate those
+    wrappers themselves.
+  </p>
+
+  <p>
+    You normally don't need to be concerned with GObject itself if you are
+    programming for GNOME with an object-oriented language.  However, making
+    yourself familiar with GObject's concepts, such as signals and slots, will
+    make your life easier as a GNOME programmer.
+  </p>
+
+  <list style="compact">
+    <item><p><link href="http://developer.gnome.org/gobject/stable/";>GObject reference 
manual</link></p></item>
+  </list>
 
 </page>
diff --git a/new-platform-overview/tech-gsettings.page b/new-platform-overview/tech-gsettings.page
index 61d28c7..c914c73 100644
--- a/new-platform-overview/tech-gsettings.page
+++ b/new-platform-overview/tech-gsettings.page
@@ -1,68 +1,44 @@
 <page xmlns="http://projectmallard.org/1.0/";
-      type="topic" id="tech-gsettings">
+      type="topic"
+      id="gsettings">
 <info>
   <link type="guide" xref="tech" group="gsettings"/>
+  <desc>Configuration storage for application preferences</desc>
+  <revision pkgversion="3.0" date="2013-01-30" status="candidate"/>
+
 </info>
 
 <title>GSettings</title>
 
-<list>
- <item>
-  <p><em style="strong">Strong selling point #1</em></p>
- </item>
- <item>
-  <p><em style="strong">Strong selling point #2</em></p>
- </item>
- <item>
-  <p><em style="strong">Strong selling point #3</em></p>
- </item>
+  <p>
+    GSettings is the part of <link xref="glib">GLib</link> that allows
+    applications to save their configuration settings and user's preferences in
+    a standard way.
+  </p>
+
+  <p>
+    An application that uses GSettings defines a <em>schema</em> of
+    configuration keys.  The schema for each key contains the key's name, a
+    human-readable description of what the key is for, a type for the key
+    (string, integer, etc.), and a default value.
+  </p>
+
+  <p>
+    GSettings uses the operating system's storage for configuration data.  On
+    GNU systems this is DConf; on Windows it is the Registry, and on Mac OS it
+    is the NextStep property list mechanism.
+  </p>
+
+  <p>
+    GSettings lets you monitor changes in keys' values, so your application can
+    respond dynamically to global changes in configuration.  For example, all
+    applications that display clocks can respond to a global setting for
+    12-hour/24-hour display immediately, without having to restart.
+  </p>
+
+  <list style="compact">
+    <item><p><link href="http://developer.gnome.org/gio/stable/GSettings.html";>GSettings Reference 
Manual</link></p></item>
 </list>
 
-<p>Marketing blurb, info on what this library offers developers.</p>
-
-<media type="image" mime="image/png" src="test_comm1.png" width="65%">
- <p>Example image</p>
-</media>
-
-
-<section id="what">
- <title>What can you do?</title>
- 
- <p>Things that <em style="strong">you can do</em> with <em style="strong"><link xref="blah">some 
feature</link></em> of the library.</p>
-</section>
-
-
-<section id="docs">
- <title>API and reference documentation</title>
- <p></p>
- <list>
-  <item>
-   <p><em style="strong"><link href="">Documentation Link</link></em></p>
-   <p>Brief description of the documentation. Maybe also some direct links to particularly interesting 
pages.</p>
-  </item>
- </list>
-</section>
-
-
-<section id="samples">
- <title>Code samples</title>
- <list>
-  <item><p>A sample we should write</p></item>
-  <item><p><link xref="samples">More...</link></p></item>
- </list>
-</section>
-
-<section id="realworld">
- <title>Real-world examples</title>
- 
- <p>This library is used in lots of open source software. Take a look at some of it.</p>
- <list>
-  <item>
-   <p><em style="strong">XXX</em> is .</p>
-   <p>(<link href="xxx">Website</link> | <link href="xxx">Screenshot</link> | <link href="xxx">Source 
code</link> )</p>
-  </item>
- </list>
-</section>
-
 
 </page>
diff --git a/new-platform-overview/tech-gstreamer.page b/new-platform-overview/tech-gstreamer.page
index 07d34fe..0ce771c 100644
--- a/new-platform-overview/tech-gstreamer.page
+++ b/new-platform-overview/tech-gstreamer.page
@@ -1,72 +1,14 @@
 <page xmlns="http://projectmallard.org/1.0/";
-      type="topic" id="tech-gstreamer">
+      type="topic"
+      id="gstreamer">
 <info>
   <link type="guide" xref="tech" group="gstreamer"/>
-  <desc>Plugin-based rich multimedia creation and delivery</desc>
+  <desc>Playing, mixing, and manipulating sound and video</desc>
   <revision pkgversion="3.0" date="2011-04-05" status="candidate"/>
 </info>
 
 <title>GStreamer</title>
 
-<list>
- <item>
-  <p><em style="strong">Strong selling point #1</em></p>
- </item>
- <item>
-  <p><em style="strong">Strong selling point #2</em></p>
- </item>
- <item>
-  <p><em style="strong">Strong selling point #3</em></p>
- </item>
-</list>
-
-<p>Marketing blurb, info on what this library offers developers.</p>
-
-<media type="image" mime="image/png" src="test_comm1.png" width="65%">
- <p>Example image</p>
-</media>
-
-
-<section id="what">
- <title>What can you do?</title>
- 
- <p>Things that <em style="strong">you can do</em> with <em style="strong"><link xref="blah">some 
feature</link></em> of the library.</p>
-</section>
-
-
-<section id="docs">
- <title>API and reference documentation</title>
- <p></p>
- <list>
-  <item>
-   <p><em style="strong"><link href="">Documentation Link</link></em></p>
-   <p>Brief description of the documentation. Maybe also some direct links to particularly interesting 
pages.</p>
-  </item>
- </list>
-</section>
-
-
-<section id="samples">
- <title>Code samples</title>
- <list>
-  <item><p>A sample we should write</p></item>
-  <item><p><link xref="samples">More...</link></p></item>
- </list>
-</section>
-
-<section id="realworld">
- <title>Real-world examples</title>
- 
- <p>This library is used in lots of open source software. Take a look at some of it.</p>
- <list>
-  <item>
-   <p><em style="strong">XXX</em> is .</p>
-   <p>(<link href="xxx">Website</link> | <link href="xxx">Screenshot</link> | <link href="xxx">Source 
code</link> )</p>
-  </item>
- </list>
-</section>
-
-<!--
 <p>GStreamer is a powerful multimedia library for playing, creating,
 and manipulating sound, video, and other media.  You can use GStreamer
 to provide sound and video playback, record input from multiple sources,
@@ -102,12 +44,11 @@ needs to manipulate sound or video.  Using GStreamer makes your
 application development easy, and it provides you well-tested
 elements for many of your needs.</p>
 
-<p>For comprehensive information on GStreamer, see <link
-href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/manual/html/index.html";>The
-GStreamer Application Development Manual</link>, <link
-href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/";>The
-GStreamer 0.10 Core Reference Manual</link>, and <link
-href="http://gstreamer.freedesktop.org/documentation/";>the
-GStreamer documentation page</link>.</p>
--->
+<list style="compact">
+  <item><p><link href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/manual/html/index.html";>The 
GStreamer Application Development Manual</link></p></item>
+  <item><p><link href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/";>The 
GStreamer 0.10 Core Reference Manual</link></p></item>
+  <item><p><link href="http://gstreamer.freedesktop.org/documentation/";>The GStreamer documentation 
page</link></p></item>
+  <item><p><link href="http://gstreamer.freedesktop.org";>The GStreamer web site</link></p></item>
+</list>
+
 </page>
diff --git a/new-platform-overview/tech-gtk.page b/new-platform-overview/tech-gtk.page
index 3a95458..3cb64b0 100644
--- a/new-platform-overview/tech-gtk.page
+++ b/new-platform-overview/tech-gtk.page
@@ -1,106 +1,44 @@
 <page xmlns="http://projectmallard.org/1.0/";
-      type="topic" id="tech-gtk">
+      type="topic"
+      id="gtk">
 <info>
   <link type="guide" xref="tech" group="gtk"/>
-  <desc>Graphical interfaces and core application support</desc>
+  <desc>Widget toolkit for graphical interfaces</desc>
   <revision pkgversion="3.0" date="2011-04-05" status="candidate"/>
 </info>
 
 <title>GTK+</title>
 
-<list>
- <item>
-  <p><em style="strong">Strong selling point #1</em></p>
- </item>
- <item>
-  <p><em style="strong">Strong selling point #2</em></p>
- </item>
- <item>
-  <p><em style="strong">Strong selling point #3</em></p>
- </item>
-</list>
-
-<p>Marketing blurb, info on what this library offers developers.</p>
-
-<media type="image" mime="image/png" src="test_comm1.png" width="65%">
- <p>Example image</p>
-</media>
-
-
-<section id="what">
- <title>What can you do?</title>
- 
- <p>Things that <em style="strong">you can do</em> with <em style="strong"><link xref="blah">some 
feature</link></em> of the library.</p>
-</section>
-
-
-<section id="docs">
- <title>API and reference documentation</title>
- <p></p>
- <list>
-  <item>
-   <p><em style="strong"><link href="">Documentation Link</link></em></p>
-   <p>Brief description of the documentation. Maybe also some direct links to particularly interesting 
pages.</p>
-  </item>
- </list>
-</section>
-
-
-<section id="samples">
- <title>Code samples</title>
- <list>
-  <item><p>A sample we should write</p></item>
-  <item><p><link xref="samples">More...</link></p></item>
- </list>
-</section>
-
-<section id="realworld">
- <title>Real-world examples</title>
- 
- <p>This library is used in lots of open source software. Take a look at some of it.</p>
- <list>
-  <item>
-   <p><em style="strong">XXX</em> is .</p>
-   <p>(<link href="xxx">Website</link> | <link href="xxx">Screenshot</link> | <link href="xxx">Source 
code</link> )</p>
-  </item>
- </list>
-</section>
-
-<!--
-<p>GTK+ is the primary library used to construct user interfaces
-in GNOME.  It provides all the user interface controls, or widgets,
-used in a common graphical application.  Its modern, object-oriented
-API allows you to construct attractive and sophisticated user
+<p>GTK+ is the primary library used to construct user interfaces in GNOME.  Its
+name stands for "GIMP Tool Kit", as originally it was explicitly
+written for that image manipulation program, and later extracted from
+it as a stand-alone library.  It provides all the user
+interface controls, or <em>widgets</em>, used in a common graphical
+application.  Its object-oriented API allows you to construct user
 interfaces without dealing with the low-level details of drawing and
 device interaction.</p>
 
 <p>In addition to basic widgets, such as buttons, check boxes,
-and text entries, GTK+ also provides powerful Model-View-Controller
+and text entries, GTK+ also provides Model-View-Controller
 (MVC) APIs for tree views, multi-line text fields, and menu and
 toolbar actions.</p>
 
-<p>Widgets in GTK+ are placed on windows using a box-packing model.
+<p>Widgets in GTK+ are placed on windows using a <em>box-packing model</em>.
 Programmers specify only how to pack widgets together in container
-boxes, rather than position them directly with absolute coordinates.
-GTK+ ensures that windows are sized correctly to fit their contents,
-and it automatically handles window resizing.</p>
-
-<p>Because GTK+ offers a flexible API, developing additional widgets
-for use in GTK+ applications is easy.  A number of third-party libraries
-exist which provide additional widgets, and many developers have created
-custom, special-purpose widgets for their applications.</p>
+boxes, instead of positioning them directly with absolute coordinates.
+Thus, GTK+ ensures that windows are sized correctly to fit their contents,
+and it automatically handles window resizing.  For right-to-left languages like
+Arabic and Hebrew, GTK+ automatically reverses the user interface from left
+to right so that controls have the expected visual order.</p>
 
-<p>GTK+ handles the difficult details of user interfaces and user
-interaction, and provides a simple yet powerful API which allows you
-to focus on the details of your application.  Applications developed
-with GTK+ will automatically follow the user's theme and font settings,
-will interact properly with accessibility technologies, and will behave
-as users expect.</p>
+<p>GTK+ allows you to develop custom widgets for use in applications, and those
+widgets.  Similar to native or stock widgets, these custom widgets can
+support all the features that GTK+ has:  right-to-left language support,
+accessibility interfaces, keyboard navigation, and automatic sizing.</p>
 
 <list style="compact">
   <item><p><link href="http://developer.gnome.org/gnome-devel-demos/stable/image-viewer.c.html";>GTK+ demo 
tutorial</link></p></item>
   <item><p><link href="http://developer.gnome.org/gtk3/stable/";>GTK+ Reference Manual</link></p></item>
   <item><p><link href="http://gtk.org/";>The GTK+ web site</link></p></item>
 </list>
--->
 </page>
diff --git a/new-platform-overview/tech-gupnp.page b/new-platform-overview/tech-gupnp.page
index 6220725..64ccb00 100644
--- a/new-platform-overview/tech-gupnp.page
+++ b/new-platform-overview/tech-gupnp.page
@@ -1,142 +1,35 @@
 <page xmlns="http://projectmallard.org/1.0/";
-      type="topic" id="tech-gupnp">
+      type="topic"
+      id="gupnp">
 <info>
   <link type="guide" xref="tech" group="gupnp"/>
-  <desc>An easy to use, efficient and flexible UPnP framework</desc>
+  <desc>Wireless, peer-to-peer, plug-and-play RPC</desc>
   <revision pkgversion="1.0" date="2011-05-17" status="candidate"/>
 </info>
 
 <title>GUPnP</title>
 
-<list>
- <item>
-  <p><em style="strong">Strong selling point #1</em></p>
- </item>
- <item>
-  <p><em style="strong">Strong selling point #2</em></p>
- </item>
- <item>
-  <p><em style="strong">Strong selling point #3</em></p>
- </item>
-</list>
 
-<p>Marketing blurb, info on what this library offers developers.</p>
+  <p>
+    Many "consumer electronics" devices that can make use of a house's local
+    network support device and service discovery via a protocol called UPnP
+    (Universal Plug and Play).  GUPnP lets GNOME applications discover UPnP
+    devices on the network, and publish services themselves.
+  </p>
 
-<media type="image" mime="image/png" src="test_comm1.png" width="65%">
- <p>Example image</p>
-</media>
+  <p>
+    DLNA is a set of standards that let devices share multimedia content in
+    standard formats.  GUPnP can also perform DLNA-related tasks such as media
+    profile guessing, transcoding to a given profile, etc.
+  </p>
 
+  <p>
+    In GNOME, GUPnP is one of the basic building blocks of home-multimedia
+    software like Rygel, a home media server.
+  </p>
 
-<section id="what">
- <title>What can you do?</title>
- 
- <p>Things that <em style="strong">you can do</em> with <em style="strong"><link xref="blah">some 
feature</link></em> of the library.</p>
-</section>
+  <list style="compact">
+    <item><p><link href="http://www.gupnp.org";>GUPnP home page</link></p></item>
+  </list>
 
-
-<section id="docs">
- <title>API and reference documentation</title>
- <p></p>
- <list>
-  <item>
-   <p><em style="strong"><link href="">Documentation Link</link></em></p>
-   <p>Brief description of the documentation. Maybe also some direct links to particularly interesting 
pages.</p>
-  </item>
- </list>
-</section>
-
-
-<section id="samples">
- <title>Code samples</title>
- <list>
-  <item><p>A sample we should write</p></item>
-  <item><p><link xref="samples">More...</link></p></item>
- </list>
-</section>
-
-<section id="realworld">
- <title>Real-world examples</title>
- 
- <p>This library is used in lots of open source software. Take a look at some of it.</p>
- <list>
-  <item>
-   <p><em style="strong">XXX</em> is .</p>
-   <p>(<link href="xxx">Website</link> | <link href="xxx">Screenshot</link> | <link href="xxx">Source 
code</link> )</p>
-  </item>
- </list>
-</section>
-
-<!--
-<p>GUPnP is an object-oriented open source framework for creating UPnP devices and control points,
-written in C using GObject and libsoup. The GUPnP API is intended to be easy to use, efficient and
-flexible.</p>
-
-<p>The GUPnP framework consists of the following components/packages:</p>
-
-<list>
-
-<item><p>GSSDP: The low-level library implementing resource discovery and announcement on the
-network through SSDP protocol.</p></item>
-
-<item><p>GUPnP: The core library that implements the UPnP specification: resource announcement and
-discovery, description, control, event notification, and presentation (GUPnP includes basic web
-server functionality through libsoup). GUPnP does not include helpers for construction or control of
-specific standardized resources (e.g. MediaServer); this is left for higher level libraries
-utilizing the GUPnP framework.</p></item>
-
-<item><p>GUPnP A/V: A small utility library that aims to ease the handling and implementation of
-UPnP A/V profiles.</p></item>
-
-<item><p>GUPnP DLNA: A small utility library that aims to ease the DLNA-related tasks such as media
-profile guessing, transcoding to a given profile, etc.</p></item>
-
-<item><p>GUPnP IGD: A library to handle UPnP Internet Gateway Device port mappings.</p></item>
-
-<item><p>GUPnP Vala: Vala bindings for GUPnP libraries.</p></item>
-
-<item><p>GUPnP Tools: Free replacements of Intel UPnP tools, that use GUPnP. They provides the
-following client and server side tools which enable one to easily test and debug one's UPnP devices
-and control points:</p>
-
-<list>
-
-<item><p>Universal Control Point: a tool that enables one to discover UPnP devices and services,
-retrieve information about them, subscribe to events and invoke actions.</p></item>
-
-<item><p>Network Light: a virtual light bulb that allows control points to switch it on and off,
-change its dimming level and query its current status. It also provides a simple UI to control all
-the network lights available on the network.</p></item>
-
-<item><p>AV Control Point: a simple media player UI that enables one to discover and play multimedia
-contents available on a network. It is strictly a control point and therefore does not have any
-playback capabilities of it's own and relies on external UPnP MediaRenderer devices for actual
-playback.</p></item>
-
-<item><p>Upload: a simple commandline utility that uploads files to known MediaServers. Use
-Universal Control Point for discovering the MediaServers.</p></item>
-
-</list>
-
-</item>
-
-</list>
-
-<p>The GUPnP framework was born out of frustration with libupnp and its mess of threads. GUPnP is
-entirely single-threaded (though asynchronous), integrates with the GLib main loop, and provides the
-same set of features as libupnp while hiding most of the UPnP internals through an elegant
-object-oriented design.</p>
-
-<p>GUPnP is free software. All libraries are released under the GNU LGPL, while GUPnP Tools are
-licensed under GNU GPL.</p>
-
-<p>You should use GUPnP whenever you need your code to communicate with any UPnP or DLNA devices.
-Examples of such devices includes Sony Playstation 3 and Bravia model TVs, Samsung TVs and phones, Microsoft 
XBox and all modern router etc. The list of such devices is huge and its increasing.</p>
-
-<p>Apart from dealing with existing UPnP devices, GUPnP can very effectively be used to easily
-create custom home network solutions where devices/services are able to discover and interact with
-each other without any configuration from user.</p>
-
-<p>For comprehensive information on GUPnP, please visit the <link
-href="http://www.gupnp.org";>project home page</link>.</p>
--->
 </page>
diff --git a/platform-overview/C/help.page b/new-platform-overview/tech-help.page
similarity index 96%
rename from platform-overview/C/help.page
rename to new-platform-overview/tech-help.page
index c0e44c1..73e20c4 100644
--- a/platform-overview/C/help.page
+++ b/new-platform-overview/tech-help.page
@@ -2,7 +2,7 @@
       type="topic"
       id="help">
 <info>
-  <link type="guide" xref="index" group="help"/>
+  <link type="guide" xref="tech" group="help"/>
   <desc>Topic-oriented online help system</desc>
   <revision pkgversion="3.0" date="2011-04-05" status="final"/>
 </info>
diff --git a/platform-overview/C/network-manager.page b/new-platform-overview/tech-network-manager.page
similarity index 96%
rename from platform-overview/C/network-manager.page
rename to new-platform-overview/tech-network-manager.page
index 8746d91..2bd7f6b 100644
--- a/platform-overview/C/network-manager.page
+++ b/new-platform-overview/tech-network-manager.page
@@ -2,7 +2,7 @@
       type="topic"
       id="network-manager">
 <info>
-  <link type="guide" xref="index" group="network-manager"/>
+  <link type="guide" xref="tech" group="network-manager"/>
   <desc>Manage network connections and monitor online/offline status</desc>
 </info>
 
diff --git a/new-platform-overview/tech-notify.page b/new-platform-overview/tech-notify.page
index dd5c9ba..e847798 100644
--- a/new-platform-overview/tech-notify.page
+++ b/new-platform-overview/tech-notify.page
@@ -1,77 +1,27 @@
 <page xmlns="http://projectmallard.org/1.0/";
-      type="topic" id="tech-notify">
+      type="topic"
+      id="notify">
 <info>
-  <link type="guide" xref="tech" group="apps"/>
-  <desc>Interactive notifications in the messaging tray</desc>
+  <link type="guide" xref="tech" group="notify"/>
+  <desc>Interactive notifications in the desktop's message tray</desc>
   <revision pkgversion="3.0" date="2011-04-05" status="incomplete"/>
 </info>
 
 <title>Notify</title>
 
-<list>
- <item>
-  <p><em style="strong">Strong selling point #1</em></p>
- </item>
- <item>
-  <p><em style="strong">Strong selling point #2</em></p>
- </item>
- <item>
-  <p><em style="strong">Strong selling point #3</em></p>
- </item>
-</list>
-
-<p>Marketing blurb, info on what this library offers developers.</p>
-
-<media type="image" mime="image/png" src="test_comm1.png" width="65%">
- <p>Example image</p>
-</media>
-
-
-<section id="what">
- <title>What can you do?</title>
- 
- 
- <p>The libnotify library provides a convenient API for presenting
-notifications to the user. Notifications can be simple message or
-they can allow the user to respond. Notifications made with libnotify
-will use the appropriate interface in the environment the application
-is running in. In GNOME 3, notifications are displayed at the bottom
-of the screen and then put into the messaging tray.</p>
- 
- <p>Things that <em style="strong">you can do</em> with <em style="strong"><link xref="blah">some 
feature</link></em> of the library.</p>
-</section>
-
-
-<section id="docs">
- <title>API and reference documentation</title>
- <p></p>
- <list>
-  <item>
-   <p><em style="strong"><link href="http://developer-next.gnome.org/libnotify/";>Libnotify Reference 
Manual</link></em></p>
-   <p>Brief description of the documentation. Maybe also some direct links to particularly interesting 
pages.</p>
-  </item>
- </list>
-</section>
-
-
-<section id="samples">
- <title>Code samples</title>
- <list>
-  <item><p>A sample we should write</p></item>
-  <item><p><link xref="samples">More...</link></p></item>
- </list>
-</section>
-
-<section id="realworld">
- <title>Real-world examples</title>
- 
- <p>This library is used in lots of open source software. Take a look at some of it.</p>
- <list>
-  <item>
-   <p><em style="strong">XXX</em> is .</p>
-   <p>(<link href="xxx">Website</link> | <link href="xxx">Screenshot</link> | <link href="xxx">Source 
code</link> )</p>
-  </item>
- </list>
-</section>
+  <p>
+    Libnotify provides an API for presenting notifications to the user.
+    Notifications can be simple messages or they can allow the user to respond.
+    For example, Empathy (GNOME's instant-messaging software) uses notifications to
+    tell the user when he gets an instant message.  Notifications made with
+    Libnotify will use the appropriate interface in the environment the application
+    is running in:  in GNOME 3, notifications are displayed at the bottom of the
+    screen and then put into the messaging tray, while other desktop shells may
+    choose to show them differently.
+  </p>
+
+  <list style="compact">
+    <item><p><link href="http://developer.gnome.org/libnotify/unstable/";>Libnotify Reference 
Manual</link></p></item>
+  </list>
 
 </page>
diff --git a/platform-overview/C/packagekit.page b/new-platform-overview/tech-packagekit.page
similarity index 95%
rename from platform-overview/C/packagekit.page
rename to new-platform-overview/tech-packagekit.page
index c306d77..0f3d418 100644
--- a/platform-overview/C/packagekit.page
+++ b/new-platform-overview/tech-packagekit.page
@@ -2,7 +2,7 @@
       type="topic"
       id="packagekit">
 <info>
-  <link type="guide" xref="index" group="packagekit"/>
+  <link type="guide" xref="tech" group="packagekit"/>
   <desc>Software installation and management</desc>
 </info>
 
diff --git a/new-platform-overview/tech-pango.page b/new-platform-overview/tech-pango.page
index 92de978..2b23af7 100644
--- a/new-platform-overview/tech-pango.page
+++ b/new-platform-overview/tech-pango.page
@@ -1,40 +1,18 @@
 <page xmlns="http://projectmallard.org/1.0/";
-      type="topic" id="tech-pango">
+      type="topic"
+      id="pango">
 <info>
   <link type="guide" xref="tech" group="pango"/>
-  <desc>Fully internationalized text layout and rendering</desc>
+  <desc>International text rendering with full Unicode support</desc>
   <revision pkgversion="3.0" date="2011-04-05" status="candidate"/>
 </info>
 
 <title>Pango</title>
 
-<list>
- <item>
-  <p><em style="strong">Strong selling point #1</em></p>
- </item>
- <item>
-  <p><em style="strong">Strong selling point #2</em></p>
- </item>
- <item>
-  <p><em style="strong">Strong selling point #3</em></p>
- </item>
-</list>
-
-<p>Marketing blurb, info on what this library offers developers.</p>
-
-<media type="image" mime="image/png" src="test_comm1.png" width="65%">
- <p>Example image</p>
-</media>
-
-
-<section id="what">
- <title>What can you do?</title>
- 
- <p>Things that <em style="strong">you can do</em> with <em style="strong"><link xref="blah">some 
feature</link></em> of the library.</p>
- 
- <p>Pango is the core text and font handling library in the GNOME
+<p>Pango is the core text and font handling library in the GNOME
 platform.  It is responsible for laying out and rendering text, and
 is used throughout GTK+.</p>
+
 <note><p>The Pango layout engine can be used with different font
 backends and drawing backends.  On most GNOME systems, Pango
 will use FreeType, fontconfig, and Cairo to access fonts and
@@ -47,11 +25,11 @@ used throughout the world.  Many of the writing systems used for
 languages have complex rules for laying out glyphs and composing
 characters.  With Pango, nearly all languages can be written and
 displayed correctly, allowing users everywhere to view text in their
-native languages.  Pango support for multiple writing systems is
+native languages.  Pango's support for multiple writing systems is
 automatic; application developers do not have to write any special
 code to support other languages.</p>
 
-<p>Pango supports the text styling used in typical documents
+<p>Pango supports the kind of text styling used in typical documents
 and interfaces, including italics, font weights, and underlines.
 Pango uses a simple XML-like vocabulary called PangoMarkup which
 enables you to set font size, color, styles, and other text
@@ -67,40 +45,9 @@ the rest of the GNOME platform.  It will help you create
 portable code, and most importantly, it will ensure that your
 application can render text correctly in hundreds of different
 languages.</p>
- 
-</section>
-
-
-<section id="docs">
- <title>API and reference documentation</title>
- <p></p>
- <list>
-  <item>
-   <p><em style="strong"><link href="http://library.gnome.org/devel/pango/stable/";>Pango Reference 
Manual</link></em></p>
-   <p>Brief description of the documentation. Maybe also some direct links to particularly interesting 
pages.</p>
-  </item>
- </list>
-</section>
-
-
-<section id="samples">
- <title>Code samples</title>
- <list>
-  <item><p>A sample we should write</p></item>
-  <item><p><link xref="samples">More...</link></p></item>
- </list>
-</section>
-
-<section id="realworld">
- <title>Real-world examples</title>
- 
- <p>This library is used in lots of open source software. Take a look at some of it.</p>
- <list>
-  <item>
-   <p><em style="strong">XXX</em> is .</p>
-   <p>(<link href="xxx">Website</link> | <link href="xxx">Screenshot</link> | <link href="xxx">Source 
code</link> )</p>
-  </item>
- </list>
-</section>
 
+<list style="compact">
+  <item><p><link href="http://library.gnome.org/devel/pango/stable/";>Pango Reference Manual</link></p></item>
+  <item><p><link href="http://www.pango.org";>The Pango web site</link></p></item>
+</list>
 </page>
diff --git a/platform-overview/C/polkit.page b/new-platform-overview/tech-polkit.page
similarity index 96%
rename from platform-overview/C/polkit.page
rename to new-platform-overview/tech-polkit.page
index c52dc61..51127cb 100644
--- a/platform-overview/C/polkit.page
+++ b/new-platform-overview/tech-polkit.page
@@ -2,7 +2,7 @@
       type="topic"
       id="policykit">
 <info>
-  <link type="guide" xref="index" group="polkit"/>
+  <link type="guide" xref="tech" group="polkit"/>
   <desc>Access control for system-level services provided through D-Bus</desc>
 </info>
 
diff --git a/platform-overview/C/poppler.page b/new-platform-overview/tech-poppler.page
similarity index 93%
rename from platform-overview/C/poppler.page
rename to new-platform-overview/tech-poppler.page
index 38668b8..00c789b 100644
--- a/platform-overview/C/poppler.page
+++ b/new-platform-overview/tech-poppler.page
@@ -2,7 +2,7 @@
       type="topic"
       id="poppler">
 <info>
-  <link type="guide" xref="index" group="poppler"/>
+  <link type="guide" xref="tech" group="poppler"/>
   <desc>PDF rendering</desc>
 </info>
 
diff --git a/platform-overview/C/pulseaudio.page b/new-platform-overview/tech-pulseaudio.page
similarity index 93%
rename from platform-overview/C/pulseaudio.page
rename to new-platform-overview/tech-pulseaudio.page
index 7c30524..886fb7a 100644
--- a/platform-overview/C/pulseaudio.page
+++ b/new-platform-overview/tech-pulseaudio.page
@@ -2,7 +2,7 @@
       type="topic"
       id="pulseaudio">
 <info>
-  <link type="guide" xref="index" group="pulseaudio"/>
+  <link type="guide" xref="tech" group="pulseaudio"/>
   <desc>Low-level audio API</desc>
 </info>
 
diff --git a/platform-overview/C/secret.page b/new-platform-overview/tech-secret.page
similarity index 98%
rename from platform-overview/C/secret.page
rename to new-platform-overview/tech-secret.page
index 99be440..a4743ec 100644
--- a/platform-overview/C/secret.page
+++ b/new-platform-overview/tech-secret.page
@@ -2,7 +2,7 @@
       type="topic"
       id="secret">
 <info>
-  <link type="guide" xref="index" group="secret"/>
+  <link type="guide" xref="tech" group="secret"/>
   <desc>Secure storage for passwords and other data</desc>
   <revision pkgversion="3.0" date="2011-04-05" status="candidate"/>
 </info>
diff --git a/new-platform-overview/tech-soup.page b/new-platform-overview/tech-soup.page
index 7304049..b2c2e18 100644
--- a/new-platform-overview/tech-soup.page
+++ b/new-platform-overview/tech-soup.page
@@ -1,70 +1,35 @@
 <page xmlns="http://projectmallard.org/1.0/";
-      type="topic" id="tech-soup">
+      type="topic"
+      id="soup">
 <info>
   <link type="guide" xref="tech" group="soup"/>
-  
   <desc>Asynchronous HTTP library with cookies, SSL, and XML-RPC</desc>
 </info>
 
 <title>Soup</title>
 
-<list>
- <item>
-  <p><em style="strong">Strong selling point #1</em></p>
- </item>
- <item>
-  <p><em style="strong">Strong selling point #2</em></p>
- </item>
- <item>
-  <p><em style="strong">Strong selling point #3</em></p>
- </item>
-</list>
-
-<p>Marketing blurb, info on what this library offers developers.</p>
-
-<media type="image" mime="image/png" src="test_comm1.png" width="65%">
- <p>Example image</p>
-</media>
-
-
-<section id="what">
- <title>What can you do?</title>
- 
- <p>Things that <em style="strong">you can do</em> with <em style="strong"><link xref="blah">some 
feature</link></em> of the library.</p>
-</section>
-
-
-<section id="docs">
- <title>API and reference documentation</title>
- <p></p>
- <list>
-  <item>
-   <p><em style="strong"><link href="">Documentation Link</link></em></p>
-   <p>Brief description of the documentation. Maybe also some direct links to particularly interesting 
pages.</p>
-  </item>
- </list>
-</section>
-
-
-<section id="samples">
- <title>Code samples</title>
- <list>
-  <item><p>A sample we should write</p></item>
-  <item><p><link xref="samples">More...</link></p></item>
- </list>
-</section>
-
-<section id="realworld">
- <title>Real-world examples</title>
- 
- <p>This library is used in lots of open source software. Take a look at some of it.</p>
- <list>
-  <item>
-   <p><em style="strong">XXX</em> is .</p>
-   <p>(<link href="xxx">Website</link> | <link href="xxx">Screenshot</link> | <link href="xxx">Source 
code</link> )</p>
-  </item>
- </list>
-</section>
-
+  <p>
+    Soup, or libsoup as it is commonly called, is an HTTP library designed to
+    be used in graphical applications which need asynchronous operations to
+    avoid blocking the user interface while network requests are going on.
+  </p>
+
+  <p>
+    Soup provides functionlity for using HTTP cookies, SSL encrypted
+    connections, and the XML-RPC protocol based on HTTP.
+  </p>
+
+  <note>
+    <p>
+      Trivia: Soup is called "soup" because it started as a library for doing SOAP
+      requests over HTTP.  Spanish speakers who are learning English frequently
+      confuse the words "soup" and "soap", and this seemed like a funny and
+      interesting name to use.
+    </p>
+  </note>
+
+  <list style="compact">
+    <item><p><link href="developer.gnome.org/libsoup/stable/">Soup reference manual</link></p></item>
+  </list>
 
 </page>
diff --git a/new-platform-overview/tech-telepathy.page b/new-platform-overview/tech-telepathy.page
index f64d6bd..2a6d2b6 100644
--- a/new-platform-overview/tech-telepathy.page
+++ b/new-platform-overview/tech-telepathy.page
@@ -1,105 +1,30 @@
 <page xmlns="http://projectmallard.org/1.0/";
       type="topic"
-      id="tech-telepathy">
+      id="telepathy">
 <info>
-  <link type="guide" xref="tech" group="apps"/>
-  <link type="guide" xref="overview-communication"/>
-
-  <desc>Unified and integrated contacts and instant messaging</desc>
+  <link type="guide" xref="tech" group="telepathy"/>
+  <desc>Unified instant-messaging and communications service</desc>
   <revision pkgversion="3.0" date="2011-04-05" status="incomplete"/>
 </info>
 
 <title>Telepathy</title>
 
-<list>
- <item>
-  <p><em style="strong">Strong selling point #1</em></p>
- </item>
- <item>
-  <p><em style="strong">Strong selling point #2</em></p>
- </item>
- <item>
-  <p><em style="strong">Strong selling point #3</em></p>
- </item>
-</list>
-
-<p>Marketing blurb, info on what this library offers developers.</p>
-
-<media type="image" mime="image/png" src="test_comm1.png" width="65%">
- <p>Example image</p>
-</media>
-
-
-<section id="what">
- <title>What can you do?</title>
- 
- <p>Things that <em style="strong">you can do</em> with <em style="strong"><link xref="blah">some 
feature</link></em> of the library.</p>
- 
 <p>Telepathy provides a powerful framework for interacting with the
 user's instant messaging contacts. With Telepathy, all accounts and
-connections are handled by a D-Bus session service that's deeply
+connections are handled by a <link xref="d-bus">D-Bus</link> session service that's deeply
 integrated into the GNOME desktop. Applications can tie into this
 service to communicate with contacts.</p>
 
 <p>With the Telepathy Tubes API, you can even tunnel an arbitrary
 protocol over modern instant messaging protocols like Jabber to
-create interactive applications. Create multi-player games or
+create interactive applications. You can create multi-player games or
 collaborative editors that integrate with the desktop-wide
 instant messaging services.</p>
- 
-<p>Mission control</p>
-
-<p>Telepathy-Glib</p>
 
-</section>
+<list style="compact">
+  <item><p><link href="http://telepathy.freedesktop.org/doc/book/";>Telepathy Developer's 
Manual</link></p></item>
+  <item><p><link href="http://telepathy.freedesktop.org";>The Telepathy web site</link></p></item>
 
-
-<section id="docs">
- <title>API and reference documentation</title>
- <p></p>
- <list style="compact">
-  <item>
-   <p><em style="strong"><link href="http://telepathy.freedesktop.org/doc/book/";>Telepathy Developer's 
Manual</link></em></p>
-   <p>Comprehensive manual, including <link href="">conceptual overviews</link>, example implementations of 
<link href="http://telepathy.freedesktop.org/doc/book/chapter.chat-example.html";>instant messaging</link>, 
<link href="http://telepathy.freedesktop.org/doc/book/chapter.voip-example.html";>voice over IP</link>, and 
<link href="http://telepathy.freedesktop.org/doc/book/chapter.tube-example.html";>Tubes</link> clients, and a 
number of <link href="http://telepathy.freedesktop.org/doc/book/source-code.html";>example programs</link> in 
C and Python. [BROKEN; LOTS OF TODO ITEMS]</p>
-  </item>
- </list>
-</section>
-
-
-<section id="samples">
- <title>Code samples</title>
- <list>
-  <item><p>A sample we should write</p></item>
-  <item><p><link xref="samples">More...</link></p></item>
- </list>
-</section>
-
-<section id="realworld">
- <title>Real-world examples</title>
- 
- <p>This library is used in lots of open source software. Take a look at some of it.</p>
- <list>
-  <item>
-   <p><em style="strong">XXX</em> is .</p>
-   <p>(<link href="xxx">Website</link> | <link href="xxx">Screenshot</link> | <link href="xxx">Source 
code</link> )</p>
-  </item>
- </list>
-</section>
-
-<section id="reading">
- <title>Further reading</title>
- <list style="compact">
-  <item>
-   <p><link href="http://www.aosabook.org/en/telepathy.html";>Telepathy (technical overview)</link>, <em>The 
Architecture of Open Source Applications</em>, Brown &amp; Wilson, June 2011.</p>
-  </item>
-  <item>
-   <p><link href="http://gnomejournal.org/article/86/telepathy-overview";>Telepathy Overview</link>, 
<em>GNOME Journal</em>, Nov 2009.</p>
-  </item>
-  <item>
-   <p><link 
href="http://gnomejournal.org/article/84/telepathy-empathy-and-mission-control-5-in-gnome-228";>Telepathy, 
Empathy and Mission Control 5 in GNOME 2.28</link>, <em>GNOME Journal</em>, Nov 2009.</p>
-  </item>
-  
- </list>
-</section>
+</list>
 
 </page>
diff --git a/new-platform-overview/tech-tracker.page b/new-platform-overview/tech-tracker.page
index 2796480..831d88b 100644
--- a/new-platform-overview/tech-tracker.page
+++ b/new-platform-overview/tech-tracker.page
@@ -1,71 +1,42 @@
 <page xmlns="http://projectmallard.org/1.0/";
       type="topic"
-      id="tech-tracker">
+      id="tracker">
 <info>
-  <link type="guide" xref="tech" group="apps"/>
-  
-  <desc>Semantic data storage with RDF and SPARQL</desc>
+  <link type="guide" xref="tech" group="tracker"/>
+  <desc>Storage and retrieval for document metadata</desc>
 </info>
 
-<title>Tracker</title>
-
-<list>
- <item>
-  <p><em style="strong">Strong selling point #1</em></p>
- </item>
- <item>
-  <p><em style="strong">Strong selling point #2</em></p>
- </item>
- <item>
-  <p><em style="strong">Strong selling point #3</em></p>
- </item>
-</list>
-
-<p>Marketing blurb, info on what this library offers developers.</p>
-
-<media type="image" mime="image/png" src="test_comm1.png" width="65%">
- <p>Example image</p>
-</media>
-
-
-<section id="what">
- <title>What can you do?</title>
- 
- <p>Things that <em style="strong">you can do</em> with <em style="strong"><link xref="blah">some 
feature</link></em> of the library.</p>
-</section>
-
-
-<section id="docs">
- <title>API and reference documentation</title>
- <p></p>
- <list>
-  <item>
-   <p><em style="strong"><link href="">Documentation Link</link></em></p>
-   <p>Brief description of the documentation. Maybe also some direct links to particularly interesting 
pages.</p>
-  </item>
- </list>
-</section>
-
-
-<section id="samples">
- <title>Code samples</title>
- <list>
-  <item><p>A sample we should write</p></item>
-  <item><p><link xref="samples">More...</link></p></item>
- </list>
-</section>
-
-<section id="realworld">
- <title>Real-world examples</title>
- 
- <p>This library is used in lots of open source software. Take a look at some of it.</p>
- <list>
-  <item>
-   <p><em style="strong">XXX</em> is .</p>
-   <p>(<link href="xxx">Website</link> | <link href="xxx">Screenshot</link> | <link href="xxx">Source 
code</link> )</p>
-  </item>
- </list>
-</section>
-
+  <title>Tracker</title>
+
+  <p>
+    Tracker is an RDF (resource data format) storage engine.  RDF consists of
+    <em>triplets</em> such as subject:verb:object.  For example, there could be
+    standard triplets for book titles and authors, such as
+    <code>Othello:has-author:William Shakespeare</code>.  A standardized set of
+    triplet forms is called an <em>ontology</em>.
+  </p>
+
+  <p>
+    Tracker provides a storage for such triplets, and a query engine in the
+    form of the SPARQL query language.
+  </p>
+
+  <p>
+    Gnome uses Tracker as a storage for document metadata.  A document's
+    metadata may include its title, authors, copyright, modification date, and
+    keywords.  All this metadata is stored as RDF triplets in Tracker, and queried
+    with SPARQL by applications such as Gnome Documents.  The <a
+      href="http://developer.gnome.org/ontology/unstable/";>ontology used</a> is based
+    on various standard sub-ontologies:  <link xref="http://dublincore.org/";>Dublin
+      Core</link> for document metadata, and <link
+      xref="http://nepomuk.kde.org/";>NEPOMUK</link> for annotations, files, contacts,
+    and other items.
+  </p>
+
+  <list style="compact">
+    <item><p><link href="http://projects.gnome.org/tracker/";>Tracker Home Page</link></p></item>
+    <item><p><link href="https://live.gnome.org/Tracker/Documentation";>Tracker 
documentation</link></p></item>
+  </list>
+  
 
 </page>
diff --git a/new-platform-overview/tech-webkit.page b/new-platform-overview/tech-webkit.page
index 72e632b..875eb63 100644
--- a/new-platform-overview/tech-webkit.page
+++ b/new-platform-overview/tech-webkit.page
@@ -1,78 +1,16 @@
 <page xmlns="http://projectmallard.org/1.0/";
       type="topic"
-      id="tech-webkit">
+      id="webkit">
 <info>
   <link type="guide" xref="tech" group="webkit"/>
-  
-  <desc>The power of HTML5 and the web in your application</desc>
+  <desc>HTML5 web page rendering</desc>
   <revision pkgversion="3.0" date="2011-04-05" status="incomplete"/>
 </info>
 
 <title>WebKit</title>
 
-
-<list>
- <item>
-  <p><em style="strong">Strong selling point #1</em></p>
- </item>
- <item>
-  <p><em style="strong">Strong selling point #2</em></p>
- </item>
- <item>
-  <p><em style="strong">Strong selling point #3</em></p>
- </item>
-</list>
-
-<p>Marketing blurb, info on what this library offers developers.</p>
-
-<media type="image" mime="image/png" src="test_comm1.png" width="65%">
- <p>Example image</p>
-</media>
-
-
-<section id="what">
- <title>What can you do?</title>
- 
- <p>Things that <em style="strong">you can do</em> with <em style="strong"><link xref="blah">some 
feature</link></em> of the library.</p>
-</section>
-
-
-<section id="docs">
- <title>API and reference documentation</title>
- <p></p>
- <list>
-  <item>
-   <p><em style="strong"><link href="">Documentation Link</link></em></p>
-   <p>Brief description of the documentation. Maybe also some direct links to particularly interesting 
pages.</p>
-  </item>
- </list>
-</section>
-
-
-<section id="samples">
- <title>Code samples</title>
- <list>
-  <item><p>A sample we should write</p></item>
-  <item><p><link xref="samples">More...</link></p></item>
- </list>
-</section>
-
-<section id="realworld">
- <title>Real-world examples</title>
- 
- <p>This library is used in lots of open source software. Take a look at some of it.</p>
- <list>
-  <item>
-   <p><em style="strong">XXX</em> is .</p>
-   <p>(<link href="xxx">Website</link> | <link href="xxx">Screenshot</link> | <link href="xxx">Source 
code</link> )</p>
-  </item>
- </list>
-</section>
-
-
-<!--
 <p>WebKit is a powerful, multi-platform HTML engine used in open
-source and commercial products. WebKitGTK+ is the port of WebKit
+source and commercial/proprietary products alike. WebKitGTK+ is the port of WebKit
 built on <link xref="gtk">GTK+</link> and integrated into the
 GNOME developer platform. WebKitGTK+ is developed upstream as
 part of the main WebKit project, so it's always up to date with
@@ -87,6 +25,5 @@ create dynamic user interfaces quickly.</p>
   <item><p><link href="http://webkitgtk.org/reference/index.html";>WebKitGTK+ Reference 
Manual</link></p></item>
   <item><p><link href="http://webkitgtk.org/";>The WebKitGTK+ web site</link></p></item>
 </list>
--->
 
 </page>
[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]