Ilias doc --> Javadoc

Klausuren/Sd1/2018summer/Exam/src/main/java/de/hdm_stuttgart/mi/sd1/aufgabe2/Artikel.java

 package de.hdm_stuttgart.mi.sd1.aufgabe2;
 
 /**
- * Darstellung von Verkaufsartikeln
+ * Darstellung von Verkaufsartikeln.
+ *
+ * <p>Ein Artikel benötigt zur Erzeugung drei Angaben: Die Bezeichnung, eine Artikelnummer sowie den Preis in
+ *    Euro-Cent (230,50€ sind beispielsweise 23050 Cent). Beispiel:</p>
+ *
+ *    <table class="goikTableDefaults">
+ *        <tr>
+ *            <th>Code</th>
+ *            <th>Gewünschtes Verhalten</th>
+ *        </tr>
+ *        <tr>
+ *            <td>
+ *                <pre>final Artikel a =
+ *new Artikel("Fahrrad", 3321, 23050);
+ *
+ *System.out.println(a);</pre>
+ *            </td>
+ *            <td>
+ *                <pre>Fahrrad, Artikelnummer 3321 zu 230,50€</pre>
+ *            </td>
+ *        </tr>
+ *    </table>
+ *
+ *    <p>Zwei Artikel Instanzen sind genau dann gleich, wenn ihre Artikelnummern übereinstimmen. Bezeichnung und Preis
+ *       sind in Bezug auf einen Vergleich hingegen irrelevant:</p>
+ *
+ *    <table class="goikTableDefaults">
+ *        <tr>
+ *            <th>Code</th>
+ *            <th>Gewünschtes Verhalten</th>
+ *        </tr>
+ *        <tr>
+ *            <td>
+ *                <pre>final Artikel
+ *   a = new Artikel("Ball",    <span style="color: green">9132</span>, 4450),
+ *   b = new Artikel("Fußball", <span style="color: green">9132</span>, 4350),
+ *   c = new Artikel("Fahrrad", <span style="color: red">3321</span>, 23050);
+ *
+ *System.out.println("Ball / Fußball: " + a.equals(b));
+ *System.out.println("Ball / Fahrrad: " + a.equals(c));</pre>
+ *            </td>
+ *            <td>
+ *                <pre>Ball / Fußball: <span style="color: green">true</span>
+ *Ball / Fahrrad: <span style="color: red">false</span></pre>
+ *            </td>
+ *        </tr>
+ *    </table>
+ *
+ *    <section class="implementationHints">
+ *        <h3>Hinweise:</h3>
+ *        <ul>
+ *            <li>Implementieren Sie alle bislang fehlenden Methoden.</li>
+ *
+ *            <li>Die Unit Tests prüfen neben der formalen Korrektheit auch die Sinnhaftigkeit der Implementierung:
+ *             Eine Hashfunktion sollte für verschiedene Objekte »meistens« unterschiedliche Werte zurückliefern.</li>
+ *        </ul>
+ *    </section>
  */
 public class Artikel {
   // TODO: Implementiere mich gemäß Aufgabenbeschreibung!

Klausuren/Sd1/2018summer/Solve/src/main/java/de/hdm_stuttgart/mi/sd1/aufgabe2/Artikel.java

 package de.hdm_stuttgart.mi.sd1.aufgabe2;
 
 /**
- * Darstellung von Verkaufsartikeln
+ * Darstellung von Verkaufsartikeln.
+ *
+ * <p>Ein Artikel benötigt zur Erzeugung drei Angaben: Die Bezeichnung, eine Artikelnummer sowie den Preis in
+ *    Euro-Cent (230,50€ sind beispielsweise 23050 Cent). Beispiel:</p>
+ *
+ *    <table class="goikTableDefaults">
+ *        <tr>
+ *            <th>Code</th>
+ *            <th>Gewünschtes Verhalten</th>
+ *        </tr>
+ *        <tr>
+ *            <td>
+ *                <pre>final Artikel a =
+ *new Artikel("Fahrrad", 3321, 23050);
+ *
+ *System.out.println(a);</pre>
+ *            </td>
+ *            <td>
+ *                <pre>Fahrrad, Artikelnummer 3321 zu 230,50€</pre>
+ *            </td>
+ *        </tr>
+ *    </table>
+ *
+ *    <p>Zwei Artikel Instanzen sind genau dann gleich, wenn ihre Artikelnummern übereinstimmen. Bezeichnung und Preis
+ *       sind in Bezug auf einen Vergleich hingegen irrelevant:</p>
+ *
+ *    <table class="goikTableDefaults">
+ *        <tr>
+ *            <th>Code</th>
+ *            <th>Gewünschtes Verhalten</th>
+ *        </tr>
+ *        <tr>
+ *            <td>
+ *                <pre>final Artikel
+ *   a = new Artikel("Ball",    <span style="color: green">9132</span>, 4450),
+ *   b = new Artikel("Fußball", <span style="color: green">9132</span>, 4350),
+ *   c = new Artikel("Fahrrad", <span style="color: red">3321</span>, 23050);
+ *
+ *System.out.println("Ball / Fußball: " + a.equals(b));
+ *System.out.println("Ball / Fahrrad: " + a.equals(c));</pre>
+ *            </td>
+ *            <td>
+ *                <pre>Ball / Fußball: <span style="color: green">true</span>
+ *Ball / Fahrrad: <span style="color: red">false</span></pre>
+ *            </td>
+ *        </tr>
+ *    </table>
+ *
+ *    <section class="implementationHints">
+ *        <h3>Hinweise:</h3>
+ *        <ul>
+ *            <li>Implementieren Sie alle bislang fehlenden Methoden.</li>
+ *
+ *            <li>Die Unit Tests prüfen neben der formalen Korrektheit auch die Sinnhaftigkeit der Implementierung:
+ *             Eine Hashfunktion sollte für verschiedene Objekte »meistens« unterschiedliche Werte zurückliefern.</li>
+ *        </ul>
+ *    </section>
  */
 public class Artikel {
   /**