From 13c751b2fa05bae2322481face3a4fb599e684b7 Mon Sep 17 00:00:00 2001
From: Martin Goik <goik@hdm-stuttgart.de>
Date: Thu, 22 Oct 2015 15:14:01 +0200
Subject: [PATCH] Adding a formats availability chapter.

---
 Doc/Sd1/preliminaries.xml  | 161 +++++++++++++++++++------------------
 Doc/Sda1/prerequisites.xml |  14 ----
 Doc/lectures.xml           |  35 +++++++-
 3 files changed, 115 insertions(+), 95 deletions(-)

diff --git a/Doc/Sd1/preliminaries.xml b/Doc/Sd1/preliminaries.xml
index 038dab056..9f154d4e0 100644
--- a/Doc/Sd1/preliminaries.xml
+++ b/Doc/Sd1/preliminaries.xml
@@ -8,85 +8,6 @@
          xmlns:db="http://docbook.org/ns/docbook">
   <title>Preliminaries</title>
 
-  <section xml:id="sd1CommonRessources">
-    <title>Common software development related resources</title>
-
-    <glosslist>
-      <glossentry xml:id="gossHdmMailRef">
-        <glossterm><xref linkend="glo_HdM"/> mail server</glossterm>
-
-        <glossdef>
-          <para>Either</para>
-
-          <itemizedlist>
-            <listitem>
-              <para>read your mails regularly</para>
-            </listitem>
-
-            <listitem>
-              <para>activate mail forwarding to your <quote>real</quote>
-              account at <link
-              xlink:href="https://mail.hdm-stuttgart.de/webmail">https://mail.hdm-stuttgart.de/webmail</link>
-              (<quote>Filter</quote> tab).</para>
-            </listitem>
-          </itemizedlist>
-        </glossdef>
-      </glossentry>
-
-      <glossentry xml:id="glossMiVpnRef">
-        <glossterm><acronym>MI <xref linkend="glo_VPN"/></acronym>
-        Installation</glossterm>
-
-        <glossdef>
-          <para>OpenVPN <acronym>wiki</acronym> <link
-          xlink:href="https://wiki.mi.hdm-stuttgart.de/wiki/VPN">installation
-          page</link> (Login required). Look for HdM_MI_stud.ovpn allowing to
-          use a maximum of MI specific services.</para>
-        </glossdef>
-      </glossentry>
-
-      <glossentry xml:id="glossMiCloudRef">
-        <glossterm>MI Cloud</glossterm>
-
-        <glossdef>
-          <para>25 GB free space. Base address <link
-          xlink:href="https://cloud.mi.hdm-stuttgart.de/owncloud">https://cloud.mi.hdm-stuttgart.de/owncloud</link>.
-          Client software for Linux, Android, <productname>IOS</productname>,
-          Windows, MacOS available at <link
-          xlink:href="http://owncloud.org/sync-clients">http://owncloud.org/sync-clients</link>.</para>
-        </glossdef>
-      </glossentry>
-
-      <glossentry xml:id="glossMiGitRef">
-        <glossterm>MI <xref linkend="glo_Soft_Git"/> / <xref
-        linkend="glo_Svn"/> repository</glossterm>
-
-        <glossdef>
-          <para><link
-          xlink:href="https://version.mi.hdm-stuttgart.de">https://version.mi.hdm-stuttgart.de</link></para>
-        </glossdef>
-      </glossentry>
-
-      <glossentry xml:id="glossMiFileserverRef">
-        <glossterm>MI file server</glossterm>
-
-        <glossdef>
-          <para><filename>Prototype user xy05 may access his home directory
-          via \\srv2.srv.mi.hdm-stuttgart.de\xy05</filename> or
-          \\192.168.111.9\xy05 respectively.</para>
-
-          <caution>
-            <para>External access requires <link
-            xlink:href="https://wiki.mi.hdm-stuttgart.de/wiki/VPN">OpenVPN</link>.
-            Be sure to select <link
-            xlink:href="https://wiki.mi.hdm-stuttgart.de/wiki/VPN#OpenVPN_Konfigurationsdatei">HdM_MI_stud.ovpn</link>
-            to gain all MI related benefits.</para>
-          </caution>
-        </glossdef>
-      </glossentry>
-    </glosslist>
-  </section>
-
   <section xml:id="sw1Resources">
     <title>Lecture related resources</title>
 
@@ -172,7 +93,8 @@
       </glossentry>
 
       <glossentry>
-        <glossterm>Supplementary exercises</glossterm>
+        <glossterm>Supplementary exercises providing automated
+        feedback</glossterm>
 
         <glossdef>
           <para><link
@@ -310,6 +232,85 @@
     </glosslist>
   </section>
 
+  <section xml:id="sd1CommonRessources">
+    <title>Common software development related resources</title>
+
+    <glosslist>
+      <glossentry xml:id="gossHdmMailRef">
+        <glossterm><xref linkend="glo_HdM"/> mail server</glossterm>
+
+        <glossdef>
+          <para>Either</para>
+
+          <itemizedlist>
+            <listitem>
+              <para>read your mails regularly</para>
+            </listitem>
+
+            <listitem>
+              <para>activate mail forwarding to your <quote>real</quote>
+              account at <link
+              xlink:href="https://mail.hdm-stuttgart.de/webmail">https://mail.hdm-stuttgart.de/webmail</link>
+              (<quote>Filter</quote> tab).</para>
+            </listitem>
+          </itemizedlist>
+        </glossdef>
+      </glossentry>
+
+      <glossentry xml:id="glossMiVpnRef">
+        <glossterm><acronym>MI <xref linkend="glo_VPN"/></acronym>
+        Installation</glossterm>
+
+        <glossdef>
+          <para>OpenVPN <acronym>wiki</acronym> <link
+          xlink:href="https://wiki.mi.hdm-stuttgart.de/wiki/VPN">installation
+          page</link> (Login required). Look for HdM_MI_stud.ovpn allowing to
+          use a maximum of MI specific services.</para>
+        </glossdef>
+      </glossentry>
+
+      <glossentry xml:id="glossMiCloudRef">
+        <glossterm>MI Cloud</glossterm>
+
+        <glossdef>
+          <para>25 GB free space. Base address <link
+          xlink:href="https://cloud.mi.hdm-stuttgart.de/owncloud">https://cloud.mi.hdm-stuttgart.de/owncloud</link>.
+          Client software for Linux, Android, <productname>IOS</productname>,
+          Windows, MacOS available at <link
+          xlink:href="http://owncloud.org/sync-clients">http://owncloud.org/sync-clients</link>.</para>
+        </glossdef>
+      </glossentry>
+
+      <glossentry xml:id="glossMiGitRef">
+        <glossterm>MI <xref linkend="glo_Soft_Git"/> / <xref
+        linkend="glo_Svn"/> repository</glossterm>
+
+        <glossdef>
+          <para><link
+          xlink:href="https://version.mi.hdm-stuttgart.de">https://version.mi.hdm-stuttgart.de</link></para>
+        </glossdef>
+      </glossentry>
+
+      <glossentry xml:id="glossMiFileserverRef">
+        <glossterm>MI file server</glossterm>
+
+        <glossdef>
+          <para><filename>Prototype user xy05 may access his home directory
+          via \\srv2.srv.mi.hdm-stuttgart.de\xy05</filename> or
+          \\192.168.111.9\xy05 respectively.</para>
+
+          <caution>
+            <para>External access requires <link
+            xlink:href="https://wiki.mi.hdm-stuttgart.de/wiki/VPN">OpenVPN</link>.
+            Be sure to select <link
+            xlink:href="https://wiki.mi.hdm-stuttgart.de/wiki/VPN#OpenVPN_Konfigurationsdatei">HdM_MI_stud.ovpn</link>
+            to gain all MI related benefits.</para>
+          </caution>
+        </glossdef>
+      </glossentry>
+    </glosslist>
+  </section>
+
   <section xml:id="sd1CodeSnippets">
     <title>Play!</title>
 
diff --git a/Doc/Sda1/prerequisites.xml b/Doc/Sda1/prerequisites.xml
index af54061d9..8d5f320f6 100644
--- a/Doc/Sda1/prerequisites.xml
+++ b/Doc/Sda1/prerequisites.xml
@@ -33,20 +33,6 @@
         </glossdef>
       </glossentry>
 
-      <glossentry>
-        <glossterm>Lecture notes as PDF</glossterm>
-
-        <glossdef>
-          <para><uri
-          xlink:href="https://freedocs.mi.hdm-stuttgart.de/index.jsp?topic=/de.hdm_stuttgart.mi.freedocs/printversion.pdf">https://freedocs.mi.hdm-stuttgart.de/index.jsp?topic=/de.hdm_stuttgart.mi.freedocs/printversion.pdf</uri></para>
-
-          <caution>
-            <para>Some content like videos in the printable version of these
-            lecture notes may be left blank.</para>
-          </caution>
-        </glossdef>
-      </glossentry>
-
       <glossentry>
         <glossterm>Live lecture additions</glossterm>
 
diff --git a/Doc/lectures.xml b/Doc/lectures.xml
index 6ed45aac1..8d60337e0 100644
--- a/Doc/lectures.xml
+++ b/Doc/lectures.xml
@@ -24,6 +24,40 @@
     </legalnotice>
   </info>
 
+  <chapter xml:id="documentFormats">
+    <title>Available formats of this document</title>
+
+    <glosslist>
+      <glossentry>
+        <glossterm>Lecture notes as PDF</glossterm>
+
+        <glossdef>
+          <para><uri
+          xlink:href="https://freedocs.mi.hdm-stuttgart.de/index.jsp?topic=/de.hdm_stuttgart.mi.lectures/printversion.pdf">https://freedocs.mi.hdm-stuttgart.de/index.jsp?topic=/de.hdm_stuttgart.mi.lectures/printversion.pdf</uri></para>
+
+          <caution>
+            <para>Some content like videos in the printable version may be
+            incomplete or even left blank.</para>
+          </caution>
+        </glossdef>
+      </glossentry>
+
+      <glossentry>
+        <glossterm>Online Version</glossterm>
+
+        <glossdef>
+          <para><uri
+          xlink:href="https://freedocs.mi.hdm-stuttgart.de">https://freedocs.mi.hdm-stuttgart.de</uri></para>
+
+          <tip>
+            <para>The online version allows for customizable full text
+            search.</para>
+          </tip>
+        </glossdef>
+      </glossentry>
+    </glosslist>
+  </chapter>
+
   <part xml:id="sd1">
     <title>Software development 1</title>
 
@@ -119,7 +153,6 @@
     <title>Persistence strategies and application development</title>
 
     <xi:include href="PersistManage/topics.xml" xpointer="element(/1)"/>
-
   </part>
 
   <xi:include href="Common/bibliography.xml" xpointer="element(/1)"/>
-- 
GitLab