From c3b79b1e074abc6fa6f0483719632f9d9c711695 Mon Sep 17 00:00:00 2001
From: Linus <justwitti@gmail.com>
Date: Sat, 23 Sep 2017 13:12:30 +0200
Subject: [PATCH] RayShape, Shape, SphereShape

---
 doc/classes/RayShape.xml    | 3 +++
 doc/classes/Shape.xml       | 2 ++
 doc/classes/SphereShape.xml | 3 +++
 3 files changed, 8 insertions(+)

diff --git a/doc/classes/RayShape.xml b/doc/classes/RayShape.xml
index 7fab9c39498..d5d367a335d 100644
--- a/doc/classes/RayShape.xml
+++ b/doc/classes/RayShape.xml
@@ -1,8 +1,10 @@
 <?xml version="1.0" encoding="UTF-8" ?>
 <class name="RayShape" inherits="Shape" category="Core" version="3.0.alpha.custom_build">
 	<brief_description>
+		Ray shape for 3D collisions.
 	</brief_description>
 	<description>
+		Ray shape for 3D collisions, which can be set into a [PhysicsBody] or [Area]. A ray is not really a collision body, instead it tries to separate itself from whatever is touching its far endpoint. It's often useful for characters.
 	</description>
 	<tutorials>
 	</tutorials>
@@ -26,6 +28,7 @@
 	</methods>
 	<members>
 		<member name="length" type="float" setter="set_length" getter="get_length">
+			The ray's length.
 		</member>
 	</members>
 	<constants>
diff --git a/doc/classes/Shape.xml b/doc/classes/Shape.xml
index 8e6e12a736d..4d822a1705d 100644
--- a/doc/classes/Shape.xml
+++ b/doc/classes/Shape.xml
@@ -1,8 +1,10 @@
 <?xml version="1.0" encoding="UTF-8" ?>
 <class name="Shape" inherits="Resource" category="Core" version="3.0.alpha.custom_build">
 	<brief_description>
+		Base class for all 3D shape resources.
 	</brief_description>
 	<description>
+		Base class for all 3D shape resources. All 3D shapes that inherit from this can be set into a [PhysicsBody] or [Area].
 	</description>
 	<tutorials>
 	</tutorials>
diff --git a/doc/classes/SphereShape.xml b/doc/classes/SphereShape.xml
index 120c7fcc258..7c6174f4e4c 100644
--- a/doc/classes/SphereShape.xml
+++ b/doc/classes/SphereShape.xml
@@ -1,8 +1,10 @@
 <?xml version="1.0" encoding="UTF-8" ?>
 <class name="SphereShape" inherits="Shape" category="Core" version="3.0.alpha.custom_build">
 	<brief_description>
+		Sphere shape for 3D collisions.
 	</brief_description>
 	<description>
+		Sphere shape for 3D collisions, which can be set into a [PhysicsBody] or [Area]. This shape is useful for modeling sphere-like 3D objects.
 	</description>
 	<tutorials>
 	</tutorials>
@@ -26,6 +28,7 @@
 	</methods>
 	<members>
 		<member name="radius" type="float" setter="set_radius" getter="get_radius">
+			The sphere's radius. The shape's diameter is double the radius.
 		</member>
 	</members>
 	<constants>