Merge branch 'feature/3-doc' into 'develop'

#3 documentation

See merge request !3

.gitlab-ci.yml

 stages:
   - test
+  - pages
 
 test:
   image: openjdk:11
@@ -10,3 +11,14 @@ test:
     reports:
       junit:
         - build/test-results/test/*.xml
+
+pages:
+  image: openjdk:11
+  stage: pages
+  script:
+    - ./gradlew javadoc
+    - rm -rf public || true
+    - mv build/docs/javadoc public
+  artifacts:
+    paths:
+      - public

src/main/java/fr/unistra/mathinfo/gl/tp/demo/FizzBuzz.java

 package fr.unistra.mathinfo.gl.tp.demo;
 
+/**
+ * FizzBuzz
+ * @see <a href="https://en.wikipedia.org/wiki/Fizz_buzz">FizzBuzz on wikipedia [en]</a>
+ */
 public interface FizzBuzz {
 
+    /**
+     * @param nombre le numero du joueur
+     * @return la réponse de FizzBuzz (nombre, Fizz, Buzz ou FizzBuzz)
+     * @throws IllegalArgumentException si nombre ≤0 ou &gt; 100
+     **/
     public String convert(int nombre);
 
 }

src/main/java/fr/unistra/mathinfo/gl/tp/demo/package-info.java

+/**
+ * <strong>Fizz buzz</strong>
+ * <small>From Wikipedia, the free encyclopedia</small>
+ * <p>Fizz buzz is a group word game for children to teach them about division.
+ *    Players take turns to count incrementally, replacing any number divisible
+ *     by three with the word "fizz", and any number divisible by five with the word "buzz".
+ * </p>
+ * <p>Players generally sit in a circle.
+ * The player designated to go first says the number "1",
+ * and the players then count upwards in turn.
+ * However, any number divisible by three is replaced by the word fizz
+ * and any number divisible by five by the word buzz.
+ * Numbers divisible by 15 become fizz buzz.
+ * A player who hesitates or makes a mistake is eliminated from the game.
+ * </p>
+ * <p>For example, a typical round of fizz buzz would start as follows:
+ * 1, 2, Fizz, 4, Buzz, Fizz, 7, 8, Fizz, Buzz, 11, Fizz, 13, 14, Fizz Buzz,
+ *  16, 17, Fizz, 19, Buzz, Fizz, 22, 23, Fizz, Buzz, 26, Fizz, 28, 29,
+ *  Fizz Buzz, 31, 32, Fizz, 34, Buzz, Fizz, ...
+ * </p>
+ */
+package fr.unistra.mathinfo.gl.tp.demo;