diff --git a/docs/images/lib2-px_sphere-1.JPG b/docs/images/lib2-px_sphere-1.JPG
new file mode 100644
index 00000000..3d823a20
Binary files /dev/null and b/docs/images/lib2-px_sphere-1.JPG differ
diff --git a/docs/lib2-px_circle.md b/docs/lib2-px_circle.md
index 5a36e5eb..18d5e16b 100644
--- a/docs/lib2-px_circle.md
+++ b/docs/lib2-px_circle.md
@@ -6,7 +6,7 @@ Returns points that can be used to draw a pixel-style circle.
 
 ## Parameters
 
-- `radius` : The circle radius.
+- `radius` : The circle radius. The value must be an integer.
 - `filled` : Default to `false`. Set it `true` if you want a filled circle.
 
 ## Examples
diff --git a/docs/lib2-px_cylinder.md b/docs/lib2-px_cylinder.md
index 8ebe2c7a..dd26b81f 100644
--- a/docs/lib2-px_cylinder.md
+++ b/docs/lib2-px_cylinder.md
@@ -6,10 +6,10 @@ Returns points that can be used to draw a pixel-style cylinder.
 
 ## Parameters
 
-- `radius` : The radius of the cylinder. It also accepts a vector `[r1, r2]`. `r1` is the bottom radius and `r2` is the top radius of a cone.
+- `radius` : The radius of the cylinder. It also accepts a vector `[r1, r2]`. `r1` is the bottom radius and `r2` is the top radius of a cone. Values must be an integer.
 - `h` : The height of the cylinder or cone. 
 - `filled` : Default to `false`. Set it `true` if you want a filled cylinder.
-- `thickness`: Default to 1. The thickness when `filled` is `false`.
+- `thickness`: Default to 1. The thickness when `filled` is `false`. The value must be an integer.
 
 ## Examples
 
diff --git a/docs/lib2-px_sphere.md b/docs/lib2-px_sphere.md
new file mode 100644
index 00000000..5dcec60c
--- /dev/null
+++ b/docs/lib2-px_sphere.md
@@ -0,0 +1,22 @@
+# px_sphere
+
+Returns points that can be used to draw a pixel-style sphere.
+
+**Since:** 2.0
+
+## Parameters
+
+- `radius` : The radius of the sphere. The value must be an integer.
+- `filled` : Default to `false`. Set it `true` if you want a filled sphere.
+- `thickness`: Default to 1. The thickness when `filled` is `false`. The value must be an integer.
+
+## Examples
+
+	include <pixel/px_sphere.scad>;
+
+	for(pt = px_sphere(10)) {
+		translate(pt)
+			cube(1, center = true);
+	}
+
+![px_sphere](images/lib2-px_sphere-1.JPG)