diff --git a/Doc/Sd1/extraExercise.xml b/Doc/Sd1/appendix.xml similarity index 61% rename from Doc/Sd1/extraExercise.xml rename to Doc/Sd1/appendix.xml index a42d6ad53bb0e50eb3ba7428fa82958233ba57c1..69853a72db35430fdaddc840f18de7a5820d48a5 100644 --- a/Doc/Sd1/extraExercise.xml +++ b/Doc/Sd1/appendix.xml @@ -1,16 +1,51 @@ <?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> diff --git a/Doc/lectures.xml b/Doc/lectures.xml index 368da039e3f63ef3ddd994da6bf8fe9932afda29..91840a068f3da037113e56d158917e86b73afa97 100644 --- a/Doc/lectures.xml +++ b/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>