[release-notes/gnome-3-12] write up the first page

[Allan Day <allanday src gnome org>]

commit 7c1ab032f6637d0c60bc033e1eee342383bb4019
Author: Allan Day <allanpday gmail com>
Date:   Tue Mar 11 15:53:10 2014 +0000

    write up the first page

 help/C/developers.page |    5 +++++
 help/C/index.page      |   29 +++++++++++++++++------------
 2 files changed, 22 insertions(+), 12 deletions(-)
---
diff --git a/help/C/developers.page b/help/C/developers.page
index b8256b0..191f581 100644
--- a/help/C/developers.page
+++ b/help/C/developers.page
@@ -67,6 +67,11 @@ replaces libnotify, but can fall back to the org.freedesktop.Notifications D-Bus
     <p>New feature: store's GraphUpdated signal delay is now configurable. This signal is what's used to 
notify of resource changes in the database (e.g. new file added). Previously it was always 1 second.</p>
   </section>
 
+  <section id="grilo-extensions">
+    <title>Grilo Extensions with Lua</title>
+    <p>The updated Videos application includes a range of online video channels that users can browse, 
search and view. Developers can easily add video channels of their own, with a simple extension  
http://www.hadess.net/2014/02/extend-gnome-videos-with-lua.html</p>
+  </section>
+
   <section id="more">
     <title>Other Improvements</title>
     <p>Unicode 6.3.0 support</p>
diff --git a/help/C/index.page b/help/C/index.page
index 677a8d6..d41d71b 100644
--- a/help/C/index.page
+++ b/help/C/index.page
@@ -24,44 +24,49 @@
     </license>
   </info>
 
-  <title>Introducing GNOME &gnomeversion;</title>
+  <title>Welcome to GNOME &gnomeversion;</title>
 
-  <p>The GNOME project is proud to present GNOME &gnomeversion;. The release comes six months after 
&lastversion;, and contains &gitcommits; changes by approximately &gitauthors; contributors. It contains 
major new features as well as a large collection of smaller enhancements. &gnomeversion; provides an improved 
experience for users, as well as new capabilities for application developers.</p>
+  <p>GNOME &gnomeversion; is the latest release of GNOME 3, and is the result of six months of hard work by 
the GNOME project. &gnomeversion; contains &gitcommits; changes by approximately &gitauthors; contributors 
and includes a number of new features alongside many smaller improvements and enhancements. It is the best 
quality GNOME 3 release to date.</p>
 
-  <p>New features in GNOME &gnomeversion; include:</p>
+  <p>New features and improvements being introduced in GNOME &gnomeversion; include:</p>
 
   <section id="videos">
     <title>Videos</title>
     <media type="image" src="figures/placeholder.png"/>
-    <p>GNOME 3.12 includes a reimagined Videos application. Modern in style and execution, the new 
application allows you to browse videos that are on your computer, as well as surf online video channels, 
including Rai.tv, The Guardian Videos channel, Blip.tv and Apple Movie Trailers. These video channels can be 
easily extended, and we expect the list to grow in the future. Additionally, integration with the popular 
Pocket service allows you to access Videos that you have saved to watch later.</p>
-    <p>The new look Videos app also includes a redesigned playback view. This gives you a non-distracting 
and focused viewing experience, with floating controls that hide when you don't need them. Fullscreen 
playback has also been massively improved.</p>
+    <p>GNOME 3.12 includes a reimagined <app>Videos</app> application. Modern in style, the new version 
allows you to browse videos that are on your computer, as well as surf online video channels, including <link 
href="http://www.rai.tv/";>Rai.tv</link>, <link href="http://www.theguardian.com/video";>The Guardian 
Videos</link> channel, <link href="http://blip.tv/";>Blip.tv</link> and <link 
href="http://trailers.apple.com/trailers/";>Apple Movie Trailers</link>. Developers can easily add new video 
channels, and we expect the list of channels you can surf to grow in the future. Additionally, integration 
with the popular Pocket service allows you to access Videos that you have saved to watch later.</p>
+    <p>The new look <app>Videos</app> app also includes a redesigned playback view. This is much more 
streamlined than the previous version: floating playback controls hide when you don't need them, so that 
nothing gets in the way of your viewing, and the fullscreen playback view also has a new more refined 
look.</p>
   </section>
 
   <section id="software">
     <title>Software Has Grown Up</title>
     <media type="image" src="figures/placeholder.png"/>
-    <p>GNOME's new Software installer application was first introduced six months ago, inversion 3.10. Since 
then it has grown up in a serious way. Performance has been improved across the board, so that common 
operations like browsing and searching for applications or installing and removing software are fast and 
responsive.</p>
-    <p>The new version includes a long list of new new features. Software now includes much richer 
information about applications, including screenshots of most applications (with new screenshots being added 
every day), and an automatic system which gives personalized star ratings for each application. Additional 
controls provide much more flexibility; you can now use Software to install individual software packages that 
have been downloaded, and you can specify which software repositories you want to use, and disable 
repositories that you have previously added.</p>
-    <p>The software updates experience has received a number of enhancements to make it more convenient to 
use. It is now possible to manually check for updates and see when the last automatic update check was 
performed. You can also opt to have your computer power off after updates have been installed, and you can 
install updates from the system power off button.</p>
+    <p>GNOME's new <app>Software</app> application was first introduced six months ago, in version 
&lastversion;. Since then it has grown up in a serious way. Performance has been improved across the board, 
so that common operations like browsing and searching for applications or installing and removing software 
are fast and responsive. The new version also includes a long list of new features, including:</p>
+    <list>
+      <item><p>Screenshots of most applications, with new screenshots being added every day.</p></item>
+      <item><p>An automatic system which gives personalized star ratings for each application</p></item>
+      <item><p>The ability to install individual software packages, such as those that you have 
downloaded.</p></item>
+      <item><p>Packages containing software repositories can be installed, and you can now review and remove 
third party repositories that are in use.</p></item>
+    </list>
+    <p>The software updates experience has also received a number of enhancements to make it more convenient 
to use. It is now possible to manually check for updates and see when the last automatic update check was 
performed. You can also opt to have your computer power off after updates have been installed, and you can 
install updates from the system power off button.</p>
   </section>
 
   <section id="rounding-out">
     <title>Rounding Things Out</title>
     <media type="image" src="figures/placeholder.png"/>
-    <p>For 3.12 we have worked with our users to round out the GNOME 3 experience. An emphasis on filling in 
requested functionality has resulted in the best quality release to date. The release has a number of changes 
that have been asked for by users. Wired networking has been added to the top bar system status area. Another 
popular request in this release is the introduction of custom application folders, which allows you to 
manually organize the application launcher view. This release also contains a number of performance 
improvements, including faster startup times and lower memory usage.</p>
-    <p>There are also many smaller changes that result in a much more polished, high quality experience. The 
visual theme and icons have had a number of subtle changes, animations have been refined so they are more 
subtle and informative. Tabs and many dialogs have been restyled to give them a consistent and more beautiful 
appearance.</p>
+    <p>For 3.12 we have worked with our users to round out the GNOME 3 experience. An emphasis on filling in 
requested functionality has resulted in a number of changes, including the addition of wired networking to 
the system status area and menu and the addition of user-configurable application folders. Many of the 
improvements to the software updates experience have also come about through dialog with users.</p>
+    <p>This release also includes many smaller changes that result in a much more polished, high quality 
experience. The visual theme and icons have had a number of subtle changes, animations have been refined so 
they are more subtle and informative, and tabs and many dialogs have been restyled to give them a consistent 
and more beautiful appearance. &gnomeversion; also contains a number of performance improvements, including 
faster startup times and lower memory usage.</p>
   </section>
 
   <section id="hi-res-displays">
     <title>Improved High Resolution Display Support</title>
     <media type="image" src="figures/placeholder.png" />
-    <p>High resolution display support was first introduced last release in 3.10. This provided 
high-resolution display support for much GNOME 3, but a number of key areas were unaddressed (in particular 
the Activities Overview, top bar, lock screen and system dialogs). Since then, high-resolution display 
support has been extended to include all aspects of the core experience, meaning that GNOME now has the best 
level of high-resolution display support of any Free Software desktop.</p>
+    <p>High resolution display support was first introduced the last GNOME release, version &lastversion;. 
This provided high-resolution display support for much GNOME 3, and for &gnomeversion; this work has 
continued. Since then, High-resolution display support has been extended to include all they key aspects of 
the core GNOME 3 experience, including the Activities Overview, top bar, lock screen and system dialogs.</p>
   </section>
 
   <section id="app-folders">
     <title>Create Your Own Application Folders</title>
     <media type="image" src="figures/placeholder.png"/>
-    <p>Several automatic app folders have existing for a couple of releases. With 3.12, it will be possible 
to manually organize your apps into folders, so you can choose.</p>
+    <p>Application folders can be found in the Activities Overview. GNOME 3 has included several automatic 
application folders in the past, which contain <gui>Utilities</gui> and <gui>Sundry</gui> items. From 
&gnomeversion;, it is possible to create your own folders, as well as move applications from the automatic 
folders to ones of your choosing. These folder management features can be found in the <app>Software</app> 
application: simply go to the <gui>Installed</gui> view, select some applications, and choose which folder 
you want them to belong to.s</p>
   </section>
 
   <section id="more">