diff --git a/src/main/java/com/generation/SimplexNoise.java b/src/main/java/com/generation/SimplexNoise.java
index a63534d1..699e0a2f 100644
--- a/src/main/java/com/generation/SimplexNoise.java
+++ b/src/main/java/com/generation/SimplexNoise.java
@@ -4,7 +4,6 @@ import java.util.Random;
 
 /**
  * Implementation of the simplex noise algorithm.
- * @see <a href="https://en.wikipedia.org/wiki/Simplex_noise">Wikipedia</a>
  */
 public class SimplexNoise {
 
@@ -16,9 +15,9 @@ public class SimplexNoise {
 	private long seed;
 	
 	/**
-	 * @param largestFeature size of the largest possible feature
-	 * @param persistence the persistence
-	 * @param seed the seed
+	 * @param largestFeature the diameter of the largest possible "cloud".
+	 * @param persistence the persistence. a low persistence causes smoother transition between the features while a high one makes the transition hard. (range = {@code 0.0F} - {@code 1.0F})
+	 * @param seed the seed this algorithm will use to generate pseudo random numbers. The generation will always look the same if the seed and the other parameters have the same value as in a previous generation
 	 */
 	public SimplexNoise(int largestFeature, double persistence, long seed) {
 		
diff --git a/src/main/java/com/generation/SimplexNoiseOctave.java b/src/main/java/com/generation/SimplexNoiseOctave.java
index 7ea25f9e..d792e127 100644
--- a/src/main/java/com/generation/SimplexNoiseOctave.java
+++ b/src/main/java/com/generation/SimplexNoiseOctave.java
@@ -45,7 +45,7 @@ public class SimplexNoiseOctave {
 	private final short[] permMod12 = new short[LENGTH];
 
 	/**
-	 * @param seed the seed for this octave
+	 * @param seed the seed that this octave uses to generate pseudo random numbers
 	 */
 	public SimplexNoiseOctave(long seed) {
 		
@@ -201,7 +201,6 @@ public class SimplexNoiseOctave {
 	 * @param y Y
 	 * @param z Z
 	 * @return the noise
-	 * @since 21.08.2018/0.2.0
 	 */
 	public double noise(double x, double y, double z) {
 		
@@ -380,7 +379,6 @@ public class SimplexNoiseOctave {
 		 * @param x X
 		 * @param y Y
 		 * @param z Z
-		 * @since 21.08.2018/0.2.0
 		 */
 		private Gradient(double x, double y, double z) {