New appendix containing examination related hints

Doc/Sd1/extraExercise.xml → Doc/Sd1/appendix.xml

 <?xml version="1.0" encoding="UTF-8"?>
-<chapter version="5.0" xml:id="sd1ExtraExercise"
-         xmlns="http://docbook.org/ns/docbook"
-         xmlns:xlink="http://www.w3.org/1999/xlink"
-         xmlns:xi="http://www.w3.org/2001/XInclude"
-         xmlns:svg="http://www.w3.org/2000/svg"
-         xmlns:m="http://www.w3.org/1998/Math/MathML"
-         xmlns:html="http://www.w3.org/1999/xhtml"
-         xmlns:db="http://docbook.org/ns/docbook">
-  <title>Supplementary exercises</title>
-
-  <section xml:id="sd1ExternalExercises">
-    <title>Recommended exercises</title>
+<appendix version="5.0" xmlns="http://docbook.org/ns/docbook"
+          xmlns:xlink="http://www.w3.org/1999/xlink"
+          xmlns:xi="http://www.w3.org/2001/XInclude"
+          xmlns:svg="http://www.w3.org/2000/svg"
+          xmlns:m="http://www.w3.org/1998/Math/MathML"
+          xmlns:html="http://www.w3.org/1999/xhtml"
+          xmlns:db="http://docbook.org/ns/docbook">
+  <title xml:id="sd1Appendix">Appendix</title>
+
+  <section xml:id="sd1ExaminationHints">
+    <title>Examination hints</title>
+
+    <para>Some programming tasks come with <xref linkend="glo_Junit"/> tests.
+    Your personal score will depend on the number of successfully executing
+    tests possibly weighted with factors modelling an individual test's
+    significance.</para>
+
+    <para>That said you should have a focus on completing units of work rather
+    than <quote>nearly</quote> finishing a large number of tasks.</para>
+
+    <caution>
+      <para>Unit testing is quite relentless. It is different from high school
+      where a wrong sign at the end of a calculation does not matter too much
+      with respect to marking.</para>
+    </caution>
+
+    <para>You should <emphasis>actively</emphasis> train debugging programs:
+    Watching a test fail is not so bad if you know how to
+    <emphasis>systematically</emphasis> fix bugs. Several options are on
+    offer:</para>
+
+    <orderedlist>
+      <listitem>
+        <para>Use a debugger, typically the one provided by Eclipse. More
+        specifically train debugging <xref linkend="glo_Junit"/> test cases
+        individually to address failing tests one by one.</para>
+      </listitem>
+
+      <listitem>
+        <para>Insert log statements into your implementation as being provided
+        by log4j.</para>
+      </listitem>
+    </orderedlist>
+  </section>
+
+  <section xml:id="sd1ExternalSupplementaryExercises">
+    <title>Recommended external exercises</title>
 
     <glosslist>
       <glossentry>
@@ -99,4 +134,4 @@
       </glossentry>
     </glosslist>
   </section>
-</chapter>
+</appendix>

Doc/lectures.xml

@@ -54,7 +54,7 @@
 
     <xi:include href="Sd1/collections.xml" xpointer="element(/1)"/>
 
-    <xi:include href="Sd1/extraExercise.xml" xpointer="element(/1)"/>
+    <xi:include href="Sd1/appendix.xml" xpointer="element(/1)"/>
   </part>
 
   <part xml:id="sda1">
@@ -107,6 +107,7 @@
     <xi:include href="Sdi/apache.xml" xpointer="element(/1)"/>
 
     <xi:include href="Sdi/samba.xml" xpointer="element(/1)"/>
+
     <xi:include href="Sdi/surveillance.xml" xpointer="element(/1)"/>
   </part>