[release-notes/gnome-3-12] fill in the last bits of the developers page

[Allan Day <allanday src gnome org>]

commit 917dd897c30bd35721042af667e7b13928b2954a
Author: Allan Day <allanpday gmail com>
Date:   Tue Mar 18 15:37:48 2014 +0000

    fill in the last bits of the developers page

 help/C/developers.page |   29 ++++++++++++++++-------------
 1 files changed, 16 insertions(+), 13 deletions(-)
---
diff --git a/help/C/developers.page b/help/C/developers.page
index f50e6b8..3a455c6 100644
--- a/help/C/developers.page
+++ b/help/C/developers.page
@@ -49,12 +49,20 @@
 
   <section id="docs">
     <title>Improved Developer Documentation</title>
-    <p>A new look (and improved content) for developer documentation</p>
+    <p>3.12 includes a raft of improvements to <app>GTK+</app>'s API reference documentation. The 
documentation has been restructured to have a more logical order. Synopsis sections have been uncluttered for 
easier reading, and widget screenshots have all been updated.</p>
+    <p>Documentation markup has also been improved across a number of libraries. <app>GTK+</app>, 
<app>GLib</app>, <app>GDK-Pixbuf</app> and <app>Clutter</app> have all been converted to use <link 
href="http://daringfireball.net/projects/markdown/";>Markdown</link>. This results in a less cluttered 
appearance and easier maintanence at source.</p>
+    <p>Finally, formatting improvements have been made for all documentation, which make it more attractive 
and easier to read.</p>
   </section>
 
-  <section id="portability">
-    <title>Enhanced Portability</title>
-    <p>Improved portability for <app>OpenBSD</app>, <app>Solaris</app>.</p>
+  <section id="wayland">
+    <title>Wayland</title>
+    <p>A huge amount of progress has been made towards full <app>Wayland</app> integration for 3.12. This 
includes the creation of a new <cmd>libinput</cmd> library and new functionality for login and session 
management. Developers who are interested in <app>Wayland</app>, or who want to test their software in a 
Wayland environment, can try the latest development work.</p>
+    <p>To run <cmd>gnome-shell</cmd> under <app>Wayland</app>, execute the following command in a 
terminal:</p>
+    <p><cmd>gnome-session --session=gnome-wayland</cmd></p>
+    <p>It is also possible to run individual applications on Wayland by specifying the 
<cmd>GDK_BACKEND</cmd>. Run the following command, substituting <input>application-name</input> for the name 
of the application's executable:</p>
+    <p><cmd>GDK_BACKEND=wayland <input>application-name</input></cmd></p>
+    <p>If an application fails to run on Wayland, it will try to fall back to X11.</p>
+    <p>Further details about GNOME on Wayland can be found on the <link 
href="https://wiki.gnome.org/Initiatives/Wayland";>GNOME Wayland wiki page</link>.</p>
   </section>
 
   <section id="tracker">
@@ -95,15 +103,10 @@
     <p>Additionally, there have been many memory and performance improvements.</p>
   </section>
 
-  <section id="wayland">
-    <title>Wayland</title>
-    <p>A huge amount of progress has been made towards full <app>Wayland</app> integration for 3.12. This 
includes the creation of a new <cmd>libinput</cmd> library and new functionality for login and session 
management. Developers who are interested in <app>Wayland</app>, or who want to test their software in a 
Wayland environment, can try the latest development work.</p>
-    <p>To run <cmd>gnome-shell</cmd> under <app>Wayland</app>, execute the following command in a 
terminal:</p>
-    <p><cmd>gnome-session --session=gnome-wayland</cmd></p>
-    <p>It is also possible to run individual applications on Wayland by specifying the 
<cmd>GDK_BACKEND</cmd>. Run the following command, substituting <input>application-name</input> for the name 
of the application's executable:</p>
-    <p><cmd>GDK_BACKEND=wayland <input>application-name</input></cmd></p>
-    <p>If an application fails to run on Wayland, it will try to fall back to X11.</p>
-    <p>Further details about GNOME on Wayland can be found on the <link 
href="https://wiki.gnome.org/Initiatives/Wayland";>GNOME Wayland wiki page</link>.</p>
+  <section id="portability">
+    <title>Enhanced Portability</title>
+    <p>Portability across different UNIX operating systems has been greatly improved for 3.12. Over 100 
<app>FreeBSD</app> issues have been reported and fixed, and test builds are also running regularly. A new 
<link href="https://wiki.gnome.org/Projects/GLib/SupportedPlatforms";>supported platforms policy</link> has 
also been introduced for <app>GLib</app>.</p>
+    <p>More details about these efforts can be found in <link 
href="http://blogs.gnome.org/desrt/2014/02/19/on-portability/";>Ryan Lortie's blog post on the 
subject</link>.</p>
   </section>
 
   <section id="more">