Continuing the rephrasing, adding screencaptures, adding a miniature image class...

diff --git a/include/newopen-session-dialog.html b/include/newopen-session-dialog.html
index f14e80ea14b04f9f028f8b9b5670fe81436e056a..e62ec7e2a08a4865e57387dad1c9491467c867ed 100644 (file)
--- a/include/newopen-session-dialog.html
+++ b/include/newopen-session-dialog.html
@@ -1,51 +1,75 @@
 
 <p>
 
 <p>

-  The initial <dfn>Session</dfn> dialog consists of several consecutive pages:
+  The initial <dfn>Session</dfn> dialog, displayed at each start of Ardour, consists
+  of several consecutive pages:

 </p>
 
 <h2>Open Session Page</h2>
 </p>
 
 <h2>Open Session Page</h2>

+
+<figure class="left">
+  <img class="mini" src="/images/session_setup.png" alt="The Session Setup Dialog">
+  <figcaption>
+    The Session Setup Dialog
+  </figcaption>
+</figure>
+
+<p>
+  On this page, an <dfn>existing session</dfn> can be opened. Any <a href="@@snapshots">snapshot</a>
+  of a particular session can also be accessed by clicking on the arrow next to
+  the session name to display all snapshots, and then selecting one.
+
+</p>
+<p>
+  If the session is not displayed in the Recent Sessions list, the <kbd
+  class="menu">Other Sessions</kbd> button will bring up a file selection dialog
+  to navigate the file system.
+</p>

 <p>
 <p>

-  On this page, you can open an <dfn>existing session</dfn>.  You can also
-  open any <a href="@@snapshots">snapshot</a> of a
-  particular session by clicking on the arrow next to the session name to
-  display all snapshots, and then selecting one.  If your session is
-  not displayed in the Recent Sessions list, the <kbd class="menu">Other
-  Sessions</kbd> button will bring up a file selection dialog to navigate
-  your hard drive.<br>
-  Alternatively, you can opt to create a <kbd class="menu">New
-  Session</kbd>.
+  Alternatively, a <kbd class="menu">New Session</kbd> can be created.

 </p>
 
 </p>
 

-<h2>New Session page</h2>
+<h2 class="clear">New Session page</h2>
+
+<figure class="left">
+  <img class="mini" src="/images/session_new.png" alt="The New Session Dialog">
+  <figcaption>
+    The New Session Dialog
+  </figcaption>
+</figure>
+

 <p>
 <p>

-  Here you can type in the name of a session, select a folder to save in, and
+  This page allows to type in the name of a session, select a folder to save it in, and

   optionally use an existing <a href="@@session-templates">template</a>.
 </p>
 <p>
   optionally use an existing <a href="@@session-templates">template</a>.
 </p>
 <p>

-  Under <dfn>Advanced Options</dfn>, you can select whether you wish to create
-  a Master Bus, or a Control Bus, and how many channels you wish either to have.
-  You can also decide whether you want Ardour to automatically connect all inputs
-  to the physical ports of your hardware. Ardour will do so
+  Under <dfn>Advanced Options</dfn>, some fine tuning can be done, like selecting
+  whether Ardour should create a Master Bus, or a Control Bus, and how many channels
+  the output should have.
+</p>
+<p>
+  Other options also decide whether Ardour should automatically connect all inputs
+  to the hardware's physical ports. Ardour will do so

   sequentially and in round-robin fashion, connecting the first track's
   sequentially and in round-robin fashion, connecting the first track's

-  input to the first input of your hardware and so on. When Ardour has used
+  input to the first input of the hardware and so on. When Ardour has used

   all available hardware inputs, it will begin again with the first physical
   input.
   all available hardware inputs, it will begin again with the first physical
   input.

-  You can limit the number of channels on your physical hardware that Ardour
-  uses.
+</p>
+<p>
+  The number of hardware channels used by Ardour can also be limited.

 </p>
 <p>
   By default Ardour will connect all tracks and busses to the Master Bus if
 </p>
 <p>
   By default Ardour will connect all tracks and busses to the Master Bus if

-  there is one. However you can also tell it to automatically connect each
-  output to the physical outputs of your interface or sound card, and limit
+  there is one. However, it can also be told to automatically connect each
+  output to the physical outputs of the interface or sound card, and limit

   the number of physical outputs used, as above.
 </p>
 
   the number of physical outputs used, as above.
 </p>
 

-<h2>Audio/MIDI Setup</h2>
+<h2 class="clear">Audio/MIDI Setup</h2>

 
 

-<figure>
-  <img src="/images/Audio-MIDI_Setup.png" alt="The Audio+MIDI Setup Dialog"/>
+<figure class="left">
+  <img class="mini" src="/images/Audio-MIDI_Setup.png" alt="The Audio/MIDI Setup Dialog"/>

   <figcaption>
   <figcaption>

-    The Audio+MIDI Setup Dialog
+    The Audio/MIDI Setup Dialog

   </figcaption>
 </figure>
 
   </figcaption>
 </figure>
 


@@ -67,46 +91,44 @@
     this will be either <kbd class="menu"><abbr title="Free Firewire Audio Driver fOr
     linux">FFADO</abbr></kbd>
     or <kbd class="menu"><abbr title="Advanced Linux Sound
     this will be either <kbd class="menu"><abbr title="Free Firewire Audio Driver fOr
     linux">FFADO</abbr></kbd>
     or <kbd class="menu"><abbr title="Advanced Linux Sound

-    Architecture">ALSA</abbr></kbd>, depending on whether or not you are
-    utilizing a firewire device. Advanced users on all platforms may also
+    Architecture">ALSA</abbr></kbd>, depending on whether or not a firewire device
+    is used. Advanced users on all platforms may also

     use <kbd class="menu">NetJack</kbd> which provides network audio I/O.
   </td></tr>
   <tr><th>Device</th>
   <td>The selector should show all availiable interfaces provided by the
   driver above and which are capable of duplex operation.
   <p class="warning">
     use <kbd class="menu">NetJack</kbd> which provides network audio I/O.
   </td></tr>
   <tr><th>Device</th>
   <td>The selector should show all availiable interfaces provided by the
   driver above and which are capable of duplex operation.
   <p class="warning">

-    If you are using an Intel Mac running OS X and the builtin audio
-    interface, you must
-    first <a href="@@using-more-than-one-audio-device">merge
-    its separate input and output devices into a single "aggregate
-    device"</a> before Ardour will be able to use it.
+    When using an Intel Mac running OS X and the builtin audio
+    interface, its separate input and output devices must be <a href="@@using-more-than-one-audio-device">
+    merged</a> first into a single "aggregate device" before Ardour will be able
+    to use it.

    </p>
   </td></tr>
   <tr><th>Sample Rate</th>
   <td>
    </p>
   </td></tr>
   <tr><th>Sample Rate</th>
   <td>

-    The selector will allow you to select from any sample rate
-    supported by the device selected above it.
+    The selector will allow to select from any sample rate supported by the device
+    selected above it.

   </td></tr>
   <tr><th>Buffer Size</th>
   <td>
   </td></tr>
   <tr><th>Buffer Size</th>
   <td>

-    You can adjust the size of the buffer used by your audio interface
+    The size of the buffer used by the audio interface can be adjusted

     to allow for either lower latency, or lower CPU usage and higher
     latency.
   </td></tr>
   <tr><th>Input/Output Channels</th>
   <td>
     to allow for either lower latency, or lower CPU usage and higher
     latency.
   </td></tr>
   <tr><th>Input/Output Channels</th>
   <td>

-    Here you can specify the number of hardware channels to use. The
+    Specifies the number of hardware channels to use. The

     default is <kbd class="menu">all available channels</kbd>.</td></tr>
   <tr><th>Hardware Input/Output Latency</th>
   <td>Specify the hardware delay in samples for precise latency compensation.</td></tr>
   <tr><th>Calibrate</th>
   <td>
     default is <kbd class="menu">all available channels</kbd>.</td></tr>
   <tr><th>Hardware Input/Output Latency</th>
   <td>Specify the hardware delay in samples for precise latency compensation.</td></tr>
   <tr><th>Calibrate</th>
   <td>

-    This button guides you through a semi-automated process to obtain
+    This button runs a semi-automated guided process to obtain

     precise hardware latency measurements for the above option.</td></tr>
   <tr><th>MIDI System</th>
   <td>
     precise hardware latency measurements for the above option.</td></tr>
   <tr><th>MIDI System</th>
   <td>

-    Select the MIDI driver to use. On Mac OS X, this will be <kbd
-    class="menu">CoreMIDI</kbd>. On Linux, you can change between two legacy
+    Selects the MIDI driver to use. On Mac OS X, this will be <kbd
+    class="menu">CoreMIDI</kbd>. On Linux, it can be changed between two legacy

     ALSA drivers or the (preferred) new JACK+ALSA implementation.</td></tr>
 </table>
     ALSA drivers or the (preferred) new JACK+ALSA implementation.</td></tr>
 </table>

-

diff --git a/include/renaming-a-session.html b/include/renaming-a-session.html
index 7ef0e876a3fc59c43a86ce2e372c2ebfbeba2beb..96baa75de632345995d8ce95f1fd753cc61c64cc 100644 (file)
--- a/include/renaming-a-session.html
+++ b/include/renaming-a-session.html
@@ -1,7 +1,7 @@
 
 <p>
 
 <p>

-  Use <kbd class="menu">Session &gt; Rename</kbd> to give the session a new
-  name. A dialog will appear asking for the new name.
+  Using the <kbd class="menu">Session &gt; Rename</kbd> menu allows to give the
+  session a new name. A dialog will appear asking for the new one.

 </p>
 
 <p>
 </p>
 
 <p>


@@ -16,4 +16,3 @@
   a new copy of the session folder and its contents. All it does is create a
   new session file.
 </p>
   a new copy of the session folder and its contents. All it does is create a
   new session file.
 </p>

-

diff --git a/include/whats-in-a-session.html b/include/whats-in-a-session.html
index cfe56d52843c439ae3a05a4ff5df9cdfa3dac8cd..0c02d3da90e0fddee121525bd6d8db95e8c01f9e 100644 (file)
--- a/include/whats-in-a-session.html
+++ b/include/whats-in-a-session.html
@@ -1,7 +1,7 @@
 
 <p>
   The <dfn>Session</dfn> is the fundamental document type that is created and
 
 <p>
   The <dfn>Session</dfn> is the fundamental document type that is created and

-  modified by the Ardour workstation.  A Session is a folder on your computer
+  modified by the Ardour workstation.  A Session is a folder on a computer

   filesystem that contains all the items that pertain to a particular project
   or "recording/editing/mixing session".
 </p>
   filesystem that contains all the items that pertain to a particular project
   or "recording/editing/mixing session".
 </p>


@@ -14,7 +14,7 @@
   <li><code><em>session_name</em>.ardour.bak</code>, the auto-backup snapshot</li>
   <li><code><em>session_name</em>.history</code>, the undo history for the session </li>
   <li><code>instant.xml</code>, which records the last-used  zoom scale and other metadata</li>
   <li><code><em>session_name</em>.ardour.bak</code>, the auto-backup snapshot</li>
   <li><code><em>session_name</em>.history</code>, the undo history for the session </li>
   <li><code>instant.xml</code>, which records the last-used  zoom scale and other metadata</li>

-  <li><code>interchange/</code>, a folder which holds your raw audio and MIDI
+  <li><code>interchange/</code>, a folder which holds the raw audio and MIDI

   files (whether imported or recorded)</li>
   <li><code>export/</code>, a folder which contains any files created by the
   <kbd class="menu">Session &gt; Export</kbd> function</li>
   files (whether imported or recorded)</li>
   <li><code>export/</code>, a folder which contains any files created by the
   <kbd class="menu">Session &gt; Export</kbd> function</li>

diff --git a/source/css/app.css b/source/css/app.css
index 6c8784dba98e88f215b787a80c56b9566acf0ca3..1ea517c70742548c48966acc3a7e69830ccc1fff 100644 (file)
--- a/source/css/app.css
+++ b/source/css/app.css
@@ -122,6 +122,12 @@ ul.inside li, ol.inside li {
   padding-bottom: .3ex;
 }
 
   padding-bottom: .3ex;
 }
 

+#content h2.clear,
+#content h3.clear,
+#content h4.clear {
+       clear:both;
+}
+

 #content h1.title {
   font-size: 1.8em;
   margin: 0 0 2ex 0;
 #content h1.title {
   font-size: 1.8em;
   margin: 0 0 2ex 0;


@@ -480,6 +486,15 @@ samp:after {
        clear: both;
 }
 
        clear: both;
 }
 

+#content img.mini {
+  width:200px;
+}
+
+#content img.mini:hover {
+  width: 100%;
+  transition: width .5s ease;
+}
+

 #content p.center {
        text-align:center;
 }
 #content p.center {
        text-align:center;
 }

diff --git a/source/images/session_new.png b/source/images/session_new.png
new file mode 100644 (file)
index 0000000..011e30b
Binary files /dev/null and b/source/images/session_new.png differ

diff --git a/source/images/session_setup.png b/source/images/session_setup.png
new file mode 100644 (file)
index 0000000..107d8a5
Binary files /dev/null and b/source/images/session_setup.png differ