diff --git a/src/break_out/controller/JSONReader.java b/src/break_out/controller/JSONReader.java
index 1c2279e..75aa597 100644
--- a/src/break_out/controller/JSONReader.java
+++ b/src/break_out/controller/JSONReader.java
@@ -28,7 +28,7 @@ public class JSONReader {
 	private String path;
 
 	/**
-	 * The stones stored as List<List<Long>>
+	 * The stones stored as List&lt;List&lt;Long&gt;&gt;
 	 */
 	private List<List<Long>> rects = new ArrayList<List<Long>>();
 
@@ -56,7 +56,7 @@ public class JSONReader {
 	/**
 	 * Getter for the stones of the JSON file
 	 *
-	 * @return The List<List<Long>> of stones
+	 * @return The List&lt;List&lt;Long&gt;&gt; of stones
 	 */
 	public List<List<Long>> getStonesListOfLists() {
 		return rects;
diff --git a/src/break_out/model/Ball.java b/src/break_out/model/Ball.java
index ff00243..a11aa62 100644
--- a/src/break_out/model/Ball.java
+++ b/src/break_out/model/Ball.java
@@ -247,7 +247,7 @@ public class Ball implements IBall {
 
 	/**
 	 * tests whether the ball touches any stone's hit box
-	 * @param stones
+	 * @param stones list of stones on the playground
 	 * @return true if the ball touches a stone
 	 */
 	public boolean hitsStone(ArrayList<Stone> stones) {
@@ -281,7 +281,7 @@ public class Ball implements IBall {
 
 	/**
 	 * returns the stone which got hit, can be null
-	 * @return
+	 * @return the stone which got hit
 	 */
 	public Stone getHitStone() {
 		return hitStone;