Update Getting Started

Language cleaned up by the technical writers xsipewe and tmanevik
from Combitech. Proofreading and corrections by Hans Bolinder.

1 files changed, 36 insertions, 27 deletions

diff --git a/system/doc/getting_started/intro.xml b/system/doc/getting_started/intro.xml
index e8d568bcaf..f9a56e4322 100644
--- a/system/doc/getting_started/intro.xml
+++ b/system/doc/getting_started/intro.xml
@@ -18,7 +18,7 @@
       basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See
       the License for the specific language governing rights and limitations
       under the License.
-    
+
     </legalnotice>
 
     <title>Introduction</title>
@@ -28,38 +28,47 @@
     <rev></rev>
     <file>intro.xml</file>
   </header>
+  <marker id="getting started"></marker>
+
+    <p>This section is a quick start tutorial to get you started with Erlang.
+      Everything in this section is true, but only part of the truth. For example,
+      only the simplest form of the syntax is shown, not all esoteric forms.
+      Also, parts that are greatly simplified are indicated with *manual*.
+      This means that a lot more information on the subject is to be found in
+      the Erlang book or in
+      <seealso marker="doc/reference_manual:introduction#erlang ref manual">
+      Erlang Reference Manual</seealso>.</p>
 
   <section>
-    <title>Introduction</title>
-    <p>This is a "kick start" tutorial to get you started with Erlang.
-      Everything here is true, but only part of the truth. For example,
-      I'll only tell you the simplest form of the syntax, not all
-      esoteric forms. Where I've greatly oversimplified things I'll
-      write *manual* which means there is lots more information to be
-      found in the Erlang book or in the <em>Erlang Reference Manual</em>.</p>
-    <p>I also assume that this isn't the first time you have touched a
-      computer and you have a basic idea about how they are programmed.
-      Don't worry, I won't assume you're a wizard programmer.</p>
+    <title>Prerequisites</title>
+
+    <p>The reader of this section is assumed to be familiar with the following:</p>
+    <list type="bulleted">
+      <item>Computers in general</item>
+      <item>Basics on how computers are programmed</item>
+    </list>
+
   </section>
 
   <section>
-    <title>Things Left Out</title>
-    <p>In particular the following has been omitted:</p>
+    <title>Omitted Topics</title>
+
+    <p>The following topics are not treated in this section:</p>
     <list type="bulleted">
-      <item>References</item>
-      <item>Local error handling (catch/throw)</item>
-      <item>Single direction links (monitor)</item>
-      <item>Handling of binary data (binaries / bit syntax)</item>
-      <item>List comprehensions</item>
-      <item>How to communicate with the outside world and/or software
-       written in other languages (ports). There is however a separate
-       tutorial for this, <em>Interoperability Tutorial</em></item>
-      <item>Very few of the Erlang libraries have been touched on (for
-       example file handling)</item>
-      <item>OTP has been totally skipped and in consequence the Mnesia
-       database has been skipped.</item>
-      <item>Hash tables for Erlang terms (ETS)</item>
-      <item>Changing code in running systems</item>
+      <item>References.</item>
+      <item>Local error handling (catch/throw).</item>
+      <item>Single direction links (monitor).</item>
+      <item>Handling of binary data (binaries / bit syntax).</item>
+      <item>List comprehensions.</item>
+      <item>How to communicate with the outside world and software
+        written in other languages (ports);
+        this is described in
+        <seealso marker="doc/tutorial:introduction#interoperability tutorial">
+        Interoperability Tutorial</seealso>.</item>
+      <item>Erlang libraries (for example, file handling).</item>
+      <item>OTP and (in consequence) the Mnesia database.</item>
+      <item>Hash tables for Erlang terms (ETS).</item>
+      <item>Changing code in running systems.</item>
     </list>
   </section>
 </chapter>