diff --git a/Shapes.md b/Shapes.md
index 90eb3ed..d044e45 100644
--- a/Shapes.md
+++ b/Shapes.md
@@ -9,6 +9,7 @@
 * [RandomSphere](RandomSphere)
 * [Sphere](Sphere)
 
+These are all the basic shapes you can get with Biosphere2.
 ***
 
 All 2D shapes (Circle, Line, Polygon and Polygon Outline) are drawn in the horizontal plane (XZ plane). 3D shapes (Cube, Cube Outline, Helix, Random Sphere and Sphere) have also a y-axis component. The orientation of the axes is always indicated in the bottom left corner of the image. The purple particles show the center of the shape. This is the reference location in the location syntax and the vector 0, 0, 0 for the vector syntax.
@@ -17,6 +18,9 @@ All 2D shapes (Circle, Line, Polygon and Polygon Outline) are drawn in the horiz
 
 ## Circle
 ![](https://i.imgur.com/j51ka40.png)
+
+Creates a list of locations or vectors in the shape of a circle. The amount of points is determined by the density and the circumference of the circle: `points = circumference * density = 2 * radius * PI * density`
+
 ### Vector Syntax
 `circle with radius %number% and density %number%`
 ### Location Syntax
@@ -26,6 +30,9 @@ All 2D shapes (Circle, Line, Polygon and Polygon Outline) are drawn in the horiz
 
 ## Cube
 ![](https://i.imgur.com/b8lKhSQ.png)
+
+Creates a list of locations or vectors in the shape of a cube. The radius determines the distance from the center to one of the vertices. If you want a cube with a certain edge length you have to use the following formula: `radius = edge length * sqrt(3) / 2`
+
 ### Vector Syntax
 `cube with radius %number%`
 ### Location Syntax
@@ -35,6 +42,9 @@ All 2D shapes (Circle, Line, Polygon and Polygon Outline) are drawn in the horiz
 
 ## Cube Outline
 ![](https://i.imgur.com/pt8KX2O.png)
+
+Creates a list of locations or vectors in the shape of a cube with its edges. The radius determines the distance from the center to one of the vertices. The amount of points is determined by the density and the edge length. `density * edge length = amount of points on one edge`. If you want a cube with a certain edge length you have to use the following formula: `radius = edge length * sqrt(3) / 2`.
+
 ### Vector Syntax
 `cube outline with radius %number% and density %number%`
 ### Location Syntax
@@ -44,6 +54,9 @@ All 2D shapes (Circle, Line, Polygon and Polygon Outline) are drawn in the horiz
 
 ## Helix
 ![](https://i.imgur.com/OoLM13C.png)
+
+Creates a list of location or vectors in the shape of a helix. The step value determines the amount of blocks the helix will move upwards during one rotation. A negative step will invert the rotation direction of the helix. The total amount of points is determined by: `points = circumference * height * density = 2 * radius * PI * height * density`
+
 ### Vector Syntax
 `helix with radius %number%, height %number%, step %number% and density %number%`
 ### Location Syntax
@@ -53,6 +66,9 @@ All 2D shapes (Circle, Line, Polygon and Polygon Outline) are drawn in the horiz
 
 ## Line
 ![](https://i.imgur.com/VOmDpUg.png)
+
+Creates a list of locations or vectors in the shape of a line. The amount of points is determined by the density and the length of the line: `points = density * length`. `line with length %number% and density %number%` returns always a line in the positive x-direction (yaw = -90).
+
 ### Vector Syntax
 ```
 line with length %number% and density %number%
@@ -65,6 +81,9 @@ vector line from %vector% to %vector% with density %number%
 
 ## Polygon
 ![](https://i.imgur.com/Qit4MDg.png)
+
+Creates list of locations or vectors in the shape of a polygon. The radius is the distance between the center and each point.
+
 ### Vector Syntax
 `polygon with %number% points and radius %number%`
 ### Location Syntax
@@ -74,6 +93,9 @@ vector line from %vector% to %vector% with density %number%
 
 ## Polygon Outline
 ![](https://i.imgur.com/BSVMrQN.png)
+
+Creates list of locations or vectors in the shape of a polygon with outlines. The radius is the distance between the center and each point. The amount of points for one line segment (between two vertices) is calculated by the edge length and the density: `points = edge length * density`
+
 ### Vector Syntax
 `polygon outline with %number% points, radius %number% and density %number%`
 ### Location Syntax
@@ -83,6 +105,9 @@ vector line from %vector% to %vector% with density %number%
 
 ## Random Sphere
 ![](https://i.imgur.com/mf5A1ji.png)
+
+Creates a list of locations or vectors in the shape of a sphere. The points are randomly distributed on the sphere surface. The radius and the density determine the amount of points: `points = (radius * PI * density)^2`
+
 ### Vector Syntax
 `random sphere with radius %number% and density %number%`
 ### Location Syntax
@@ -92,6 +117,9 @@ vector line from %vector% to %vector% with density %number%
 
 ## Sphere
 ![](https://i.imgur.com/trB8zrH.png)
+
+Creates a list of locations or vectors in the shape of a sphere. The sphere is formed by a series of circles with different diameters. The radius and the density determine the amount of points: `points = (radius * PI * density)^2`
+
 ### Vector Syntax
 `sphere with radius %number% and density %number%`
 ### Location Syntax