[gnome-devel-docs] tutorials <javascript>: Improved the explanations on the beginner page index

[Tiffany Antopolski <antopolski src gnome org>]

commit a4056d62d37bf4eefce4e47070f797c2a352167f
Author: Taryn Fox <jewelfox fursona net>
Date:   Tue Jun 12 13:33:26 2012 -0400

    tutorials <javascript>: Improved the explanations on the beginner page index

 platform-demos/C/beginner.js.page |   21 ++++++++++++++-------
 1 files changed, 14 insertions(+), 7 deletions(-)
---
diff --git a/platform-demos/C/beginner.js.page b/platform-demos/C/beginner.js.page
index 05df3b4..73f1c8a 100644
--- a/platform-demos/C/beginner.js.page
+++ b/platform-demos/C/beginner.js.page
@@ -4,7 +4,7 @@
       id="beginner.js">
   <info>
     <link type="guide" xref="js"/>
-    <revision version="0.1" date="2012-02-19" status="stub"/>
+    <revision version="0.2" date="2012-06-10" status="draft"/>
 
     <credit type="author copyright">
       <name>Susanna Huhtanen</name>
@@ -12,11 +12,19 @@
       <years>2012</years>
     </credit>
 
-    <desc>A complete beginner's guide to GTK+ programming</desc>
+    <desc>A beginner's guide to GUI programming using GTK+, including code samples and practice exercises.</desc>
   </info>
 
-  <title>0 Beginner's Tutorials and samples</title>
-  <p>In these tutorials and samples we use JavaScript and GTK+. These tutorials and samples expect you to be familiar with the syntax of JavaScript. If you're not, read <link href="http://eloquentjavascript.net/contents.html";>Eloquent JavaScript</link> or another guide, to learn how to write JavaScript code.</p>
+  <title>0 Beginner's tutorials and samples</title>
+<synopsis>
+ <p>These tutorials are designed for people who already know how to write in JavaScript, and who have GNOME installed on their computers already, but are new to developing GNOME applications. If you don't already know JavaScript, or if you need help getting GNOME set up, take a look at these resources first:</p>
+<list type="numbered">
+  <item><p><link href="http://eloquentjavascript.net/contents.html";>Eloquent JavaScript</link> is a free, Creative Commons-licensed book, which explains the basics of JavaScript programming. Since you won't be writing JavaScript for the web, you only need to read up to chapter 10 or so.</p></item>
+  <item><p><link href="http://www.gnome.org/getting-gnome/";>Download GNOME</link> as part of a distribution, like Fedora, openSUSE, or Ubuntu. If you're already using one of those distributions, you can install GNOME using its package manager, then log out and choose a GNOME session as you log back in.</p></item>
+</list>
+ <p>JavaScript is normally seen as a basic web scripting language, but despite its simplicity it's also a first-class language for writing GNOME applications with. Unlike with other platforms, GNOME applications written in JavaScript aren't web apps running on the desktop and using a limited set of features. In fact, <link href="https://live.gnome.org/GnomeShell/Tour";>GNOME Shell</link> itself is written in JavaScript, and you can use JavaScript to write your own extensions for it as well as full-featured applications.</p>
+ <p>These tutorials will teach you the basics of how to do so, and show you how to find more detailed reference material for when you are ready to move on.</p>
+</synopsis>
 
 <section id="tutorials">
 <title>Tutorials</title>
@@ -24,9 +32,8 @@
 
 <section id="samples">
 <title>Code samples</title>
-  <p>
-    To run the code samples:
-  </p>
+  <p>These samples show how to use certain widgets and features in your GNOME applications. Each one demonstrates a complete application which showcases the featured widget, and may have step-by-step instructions which show how to build and customize it. Links at the end of each sample will take you to more detailed reference material, if you need it.</p>
+  <p>To run the code samples:</p>
   <steps>
     <item><p>Copy and paste the code into <var>filename</var>.js</p></item>
     <item><p>In the terminal, type:</p>