Rewritten "Getting Ready" making more uniform UNIX/Windows steps.

Closes carpentries-incubator#1

index.html

@@ -52,10 +52,21 @@ <h2 id="getting-ready"><span class="glyphicon glyphicon-check"></span>Getting re
 <div class="panel-body">
 <ol style="list-style-type: decimal">
 <li>In your home directory, create a new directory called <code>avgord</code>.</li>
-<li><strong>Only on Linux and OS X:</strong> in the terminal, navigate to that directory using the <code>cd</code> command.</li>
-<li>Start GAP: on Linux and OS X, call <code>gap4r7/bin/gap.sh</code> (edit the path as needed); on Windows, call it via the appropriate menu or by double-clicking on the <code>gap4r7/bin/gap.bat</code> file in your GAP installation.</li>
-<li><strong>Only on Windows:</strong> set <code>avgord</code> to be your current directory using the command <code>ChangeDirectoryCurrent(&quot;C:/Users/username/avgord&quot;);</code> (edit the path as needed, remember to use <code>/</code>&quot; instead of <code>\</code>).</li>
-<li>Check that your current directory is set up properly: on Linux and OS X, call <code>Exec(&quot;pwd&quot;);</code>; on Windows, call <code>Exec(&quot;DIR&quot;);</code>. The path that you will see in the output should be the path to the <code>avgord</code> directory.</li>
+<li>Start GAP:</li>
+</ol>
+<ul>
+<li>on Linux and OS X, call <code>path-to-your-gap-installation/gap4r8/bin/gap.sh</code> (edit the path as necessary);</li>
+<li>on Windows, call it via the appropriate menu or by double-clicking on the <code>gap4r8/bin/gap.bat</code> file in your GAP installation.</li>
+</ul>
+<ol start="3" style="list-style-type: decimal">
+<li>Set your current directory to <code>avgord</code> calling <code>ChangeDirectoryCurrent</code> from the IO package (if GAP is installed correctly, by default it should be loaded when GAP starts):</li>
+</ol>
+<ul>
+<li>on Linux and OS X, call <code>ChangeDirectoryCurrent(&quot;/home/username/avgord&quot;);</code> (edit the path as necessary; remember to type the full path to your home directory instead of <code>~</code>).</li>
+<li>on Windows, call <code>ChangeDirectoryCurrent(&quot;C:/Users/username/avgord&quot;);</code> (edit the path as necessary; remember to use <code>/</code> instead of <code>\</code>).</li>
+</ul>
+<ol start="4" style="list-style-type: decimal">
+<li>Check that your current directory is set up properly: call <code>DirectoryCurrent();</code> and the path that you will see in the output should point to the <code>avgord</code> directory.</li>
 </ol>
 </div>
 </section>

index.md

@@ -41,17 +41,21 @@ On this path, the learner will became familiar with:
 
 > ## Getting ready {.getready}
 > 1. In your home directory, create a new directory called `avgord`.
-> 2. **Only on Linux and OS X:** in the terminal, navigate to that directory
->    using the `cd` command.
-> 3. Start GAP: on Linux and OS X, call `gap4r7/bin/gap.sh` (edit the path as
->    needed); on Windows, call it via the appropriate menu or by double-clicking
->    on the `gap4r7/bin/gap.bat` file in your GAP installation.
-> 4. **Only on Windows:** set `avgord` to be your current directory using the
->    command `ChangeDirectoryCurrent("C:/Users/username/avgord");` (edit the
-path as needed, remember to use `/`" instead of `\`).
-> 5. Check that your current directory is set up properly: on Linux and OS X,
->    call `Exec("pwd");`; on Windows, call `Exec("DIR");`. The path that you
->    will see in the output should be the path to the `avgord` directory.
+> 2. Start GAP:
+> * on Linux and OS X, call `path-to-your-gap-installation/gap4r8/bin/gap.sh`
+>    (edit the path as necessary);
+> * on Windows, call it via the appropriate menu or
+>    by double-clicking on the `gap4r8/bin/gap.bat` file in your GAP installation.
+> 3. Set your current directory to `avgord` calling `ChangeDirectoryCurrent` from
+>    the IO package (if GAP is installed correctly, by default it should be loaded
+>    when GAP starts):
+> * on Linux and OS X, call `ChangeDirectoryCurrent("/home/username/avgord");`
+>    (edit the path as necessary; remember to type the full path to your home
+>    directory instead of `~`).
+> * on Windows, call `ChangeDirectoryCurrent("C:/Users/username/avgord");`
+>    (edit the path as necessary; remember to use `/` instead of `\`).
+> 4. Check that your current directory is set up properly: call `DirectoryCurrent();`
+>    and the path that you will see in the output should point to the `avgord` directory.
 
 ## Topics