[gnome-devel-docs] tutorials <javascript>: Improved the JavaScript beginner tutorials page

[Tiffany Antopolski <antopolski src gnome org>]

commit 243f1b688b497d907c303e5ef4cf3e46a727d9cd
Author: Taryn Fox <jewelfox fursona net>
Date:   Tue Jul 17 06:57:41 2012 -0400

    tutorials <javascript>: Improved the JavaScript beginner tutorials page

 platform-demos/C/beginner.js.page |   24 +++++++++++++++---------
 1 files changed, 15 insertions(+), 9 deletions(-)
---
diff --git a/platform-demos/C/beginner.js.page b/platform-demos/C/beginner.js.page
index 73f1c8a..1892fd5 100644
--- a/platform-demos/C/beginner.js.page
+++ b/platform-demos/C/beginner.js.page
@@ -12,27 +12,33 @@
       <years>2012</years>
     </credit>
 
-    <desc>A beginner's guide to GUI programming using GTK+, including code samples and practice exercises.</desc>
+    <desc>A beginner's guide to writing GNOME applications in JavaScript, including code samples and practice exercises.</desc>
   </info>
 
   <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>
+  <p>JavaScript is one of the most popular programming languages on the web. It's not just for the web, though. If you have even a basic understanding of JavaScript, you can write full-fledged applications for GNOME. <link href="https://live.gnome.org/GnomeDocuments";>GNOME Documents</link> is written in JavaScript, and so is <link href="https://live.gnome.org/GnomeShell/Tour";>GNOME Shell,</link> the most basic part of GNOME.</p>
+  <note style="tip"><p>GNOME Shell is what you see when you click on "Activities" in the top-left corner of your screen. It also controls the clock and the rest of the top panel. Besides showing how you to write GNOME applications, these tutorials will also show you how to use JavaScript to write GNOME Shell extensions, which give it new features or change the way it does things.</p></note>
 </synopsis>
 
+<section id="getting started">
+<title>Getting Started</title>
+ <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 who 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>
+<steps>
+  <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. Each distribution has its own instructions for how to get GNOME.</p></item>
+  <item><p><link xref="set-up-gedit.js">Set up gedit</link> for writing applications. GNOME's text editor, gedit, is sometimes just called "text editor."</p></item>
+</steps>
+</section>
+
+
 <section id="tutorials">
 <title>Tutorials</title>
 </section>
 
 <section id="samples">
 <title>Code samples</title>
-  <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>These samples show how to use widgets in your GNOME applications. Each one demonstrates a complete application which showcases the featured widget. At the end of each sample, you will find links to more detailed reference material.</p>
   <p>To run the code samples:</p>
   <steps>
     <item><p>Copy and paste the code into <var>filename</var>.js</p></item>