From 743b693b8affb582f019df53c434fc7454f7ffc7 Mon Sep 17 00:00:00 2001
From: Martin Goik <goik@hdm-stuttgart.de>
Date: Wed, 22 Nov 2017 11:56:46 +0100
Subject: [PATCH] Exam procedure overview

---
 Doc/Sd1/gettingStarted.xml | 73 +++++++++++++++++++++++++++++++-------
 1 file changed, 60 insertions(+), 13 deletions(-)

diff --git a/Doc/Sd1/gettingStarted.xml b/Doc/Sd1/gettingStarted.xml
index bc9195bed..6f4ff7e9f 100644
--- a/Doc/Sd1/gettingStarted.xml
+++ b/Doc/Sd1/gettingStarted.xml
@@ -819,16 +819,20 @@ loop # 12</screen>
     <xref linkend="glo_Java"/> projects. For various reasons to be explained
     later the <xref linkend="glo_IDE"/> also supports the <xref
     linkend="glo_Maven"/> build software which among other features offers
-    both automated testing your code and logging messages at runtime.
-    Meanwhile <xref linkend="glo_Maven"/> allows to open your projects on
+    both automated testing your code and logging messages at runtime. Moreover
+    <xref linkend="glo_Maven"/> allows for working on projects choosing
     different platforms (Linux, Windows, Mac-OS): Thus you benefit from
     seamlessly working on your exercises both at HdM and when using your
     private Hardware.</para>
 
     <para><xref linkend="glo_Maven"/> is based on so called archetypes being
-    blueprints for projects. Since the MI department provides enhanced
-    versions of publicly available archetypes these corresponding repository
-    must be configured in the <productname
+    blueprints for projects. The MI department provides enhanced versions of
+    publicly available archetypes. In addition <link
+    xlink:href="https://maven.apache.org/glossary.html">Maven artifacts</link>
+    (libraries) are being provided as well. The <link
+    xlink:href="https://maven.mi.hdm-stuttgart.de">corresponding
+    repository</link> must be configured to be used both by command line or
+    within the <productname
     xlink:href="https://www.jetbrains.com/idea">IntelliJ IDEA</productname>
     <xref linkend="glo_IDE"/>.</para>
 
@@ -1279,14 +1283,57 @@ public class App {
     </section>
 
     <section xml:id="sd1_sect_ideaMavenImport">
-      <title>Importing <xref linkend="glo_Maven"/> projects in <xref
-      linkend="glo_Soft_IntellijIDEA"/></title>
-
-      <para>Many solutions to this lecture notes' exercises are being provided
-      as <xref linkend="glo_Maven"/> projects. Comparing them to your own
-      solution requires an import to your <xref linkend="glo_IDE"/>. Moreover
-      the final examination and some exercises require importing <xref
-      linkend="glo_Maven"/> skeleton projects to start from.</para>
+      <title>Examination <xref linkend="glo_Maven"/> <xref
+      linkend="glo_Soft_IntellijIDEA"/> import.</title>
+
+      <para>Lecture notes exercise solutions are being provided as <xref
+      linkend="glo_Maven"/> projects below <link
+      xlink:href="https://gitlab.mi.hdm-stuttgart.de/goik/GoikLectures/tree/master/P/Sd1">P/Sd1</link>
+      by the <link xlink:href="https://gitlab.mi.hdm-stuttgart.de">MI
+      Gitlab</link> repository. Comparing them to your own solution requires
+      an import to your <xref linkend="glo_IDE"/>.</para>
+
+      <para>Moreover the final examination and some exercises require
+      importing <xref linkend="glo_Maven"/> skeleton projects to start from.
+      The general procedure during an examination with respect to programming
+      components is:</para>
+
+      <figure xml:id="sd1_fig_examProcedure">
+        <title>Programming projects in examinations</title>
+
+        <orderedlist>
+          <listitem>
+            <para>Start an <productname>ILIAS</productname> programming
+            task.</para>
+          </listitem>
+
+          <listitem>
+            <para>Download a skeleton project e.g.
+            <filename>exam.zip</filename>.</para>
+          </listitem>
+
+          <listitem>
+            <para>Unzip <filename>exam.zip</filename> and import the resulting
+            folder <filename>Exam</filename> into
+            <productname>IntelliJ</productname>.</para>
+          </listitem>
+
+          <listitem>
+            <para>Implement <emphasis role="red">and test</emphasis> the
+            desired features.</para>
+          </listitem>
+
+          <listitem>
+            <para>Zip up your project folder <filename>Exam</filename> to e.g.
+            <filename>solution-1.zip</filename>.</para>
+          </listitem>
+
+          <listitem>
+            <para>Upload <filename>solution-1.zip</filename> into
+            <productname>ILIAS</productname>.</para>
+          </listitem>
+        </orderedlist>
+      </figure>
 
       <para>The subsequent screenshots assist in gaining the technical skills
       to do so. They describe importing a skeleton project during the
-- 
GitLab