Doc alignment

Klausuren/Sda1/2018Summer/Solve/Doc/.gitignore

+task*.html

Klausuren/Sda1/2018Summer/Solve/Doc/exam.xml

@@ -144,15 +144,6 @@
             </orderedlist></td>
         </tr>
       </informaltable>
-
-      <para>Complete the schema implementation in
-      <filename>Schema/bib.xsd</filename>. <productname>Junit</productname>
-      execution of
-      <classname>de.hdm_stuttgart.mi.sda1.test.ex1.ShowReachedPoints</classname>
-      loads all unit tests based on files residing in your project's folder
-      <filename>SchemaTest</filename>. In turn you receive your number of
-      points reached so far including detailed hints about failed
-      tests.</para>
     </section>
 
     <section xml:id="aufgabe1_task">
@@ -168,19 +159,27 @@
           files testing your schema for correctness.</para>
         </listitem>
 
+        <listitem>
+          <para><productname>Junit</productname> test execution of
+          <classname>de.hdm_stuttgart.mi.sda1.test.ex1.Test_SchemaByInstances</classname>
+          triggers validation of instance samples in your
+          <filename>SchemaTest</filename> folder.</para>
+        </listitem>
+
         <listitem>
           <para>Executing
           <classname>de.hdm_stuttgart.mi.sda1.test.ex1.ShowReachedPoints</classname>
-          as a Java application indicates which test documents in
-          <filename>SchemaTest</filename> yet fail the expected outcome being
-          either <quote>valid</quote> of <quote>invalid</quote>. You also get
-          the number of points reached so far.</para>
+          as a Java application provides the number of points reached so
+          far.</para>
         </listitem>
 
         <listitem>
-          <para>Open all XML related files in
-          <productname>Oxygenxml</productname> offering better schema support
-          than IntelliJ.</para>
+          <para>Opening all XML related files in
+          <productname>Oxygenxml</productname> rather than using IntelliJ
+          offers better schema support. Due to better IDE integration
+          (<abbrev>i.e.</abbrev> clicking on <productname>Junit</productname>
+          file references in idea's console view) you may however use IntelliJ
+          for »simple« tasks at your own risk.</para>
         </listitem>
       </orderedlist>
 
@@ -194,8 +193,8 @@
 
           <listitem>
             <para>Edit <filename>Schema/bib.xsd</filename> by small steps and
-            always execute the tests: In case of spoiling the
-            <quote>undo</quote> operation is your friend.</para>
+            always execute the tests: The <quote>undo</quote> operation is
+            your friend in case of spoiled tests.</para>
           </listitem>
         </itemizedlist>
       </tip>
@@ -205,21 +204,22 @@
       <title>Project upload</title>
 
       <para>Hit »File« --&gt; »Export to Zip File« in IDEA archiving your
-      project as <filename>solution-1.zip</filename>. Then enter your ILIAS
-      tab, hit <quote>choose</quote> selecting
+      project as <filename>solution-1.zip</filename>. Then enter your
+      browser's ILIAS tab, hit <quote>choose</quote> selecting
       <filename>solution-1.zip</filename> and subsequently
-      <quote>upload</quote>. Do not forget to advance to the next question to
-      actually save the current question. Common pitfalls:</para>
+      <quote>upload</quote>. Do not forget to advance to the next question for
+      actually saving the current question. Common pitfalls:</para>
 
       <itemizedlist>
         <listitem>
-          <para>Upload the right archive: Avoid choosing the original
+          <para>Upload the intended archive: Avoid choosing the original
           <filename>exam.zip</filename> skeleton.</para>
         </listitem>
 
         <listitem>
           <para>Watch out for <filename>solution_1.zip</filename> actually
-          being visible in the examination system.</para>
+          being visible in the examination system especially when finishing
+          the exam.</para>
         </listitem>
 
         <listitem>

ws/Docbook/CustomLayer/Klausur/docbook2klausur.xsl

@@ -201,7 +201,11 @@
             <xsl:apply-templates/>
         </span>
     </xsl:template>
-    
+
+    <xsl:template match="db:abbrev">
+        <xsl:apply-templates/>
+    </xsl:template>
+
     <xsl:template match="db:package">
         <span style="font-size:90%; font-family: 'Lucida Console', Monaco, monospace; color: #FB6019;">
             <xsl:apply-templates/>
@@ -406,4 +410,4 @@
         </xsl:choose>
     </xsl:template>
     
-</xsl:stylesheet>
\ No newline at end of file
+</xsl:stylesheet>