[DOCS] Many class ref updates

doc/classes/BakedLightmap.xml

@@ -1,8 +1,10 @@
 <?xml version="1.0" encoding="UTF-8" ?>
 <class name="BakedLightmap" inherits="VisualInstance" category="Core" version="3.1">
 	<brief_description>
+		Prerendered indirect light map for a scene.
 	</brief_description>
 	<description>
+		Baked lightmaps are an alternative workflow for adding indirect (or baked) lighting to a scene. Unlike the [GIProbe] approach, baked lightmaps work fine on low-end PCs and mobile devices as they consume almost no resources in run-time.
 	</description>
 	<tutorials>
 		<link>http://docs.godotengine.org/en/3.0/tutorials/3d/baked_lightmaps.html</link>
@@ -29,36 +31,49 @@
 	</methods>
 	<members>
 		<member name="bake_cell_size" type="float" setter="set_bake_cell_size" getter="get_bake_cell_size">
+			Grid subdivision size for lightmapper calculation. Default value of [code]0.25[/code] will work for most cases. Increase for better lighting on small details or if your scene is very large.
 		</member>
 		<member name="bake_energy" type="float" setter="set_energy" getter="get_energy">
 		</member>
 		<member name="bake_extents" type="Vector3" setter="set_extents" getter="get_extents">
+			Size of affected area.
 		</member>
 		<member name="bake_hdr" type="bool" setter="set_hdr" getter="is_hdr">
+			If [code]true[/code] lightmap can capture light values greater than [code]1.0[/code]. Turning this off will result in a smaller lightmap. Default value:[code]false[/code].
 		</member>
 		<member name="bake_mode" type="int" setter="set_bake_mode" getter="get_bake_mode" enum="BakedLightmap.BakeMode">
+			Lightmapping mode. See [enum BakeMode].
 		</member>
 		<member name="bake_propagation" type="float" setter="set_propagation" getter="get_propagation">
 		</member>
 		<member name="bake_quality" type="int" setter="set_bake_quality" getter="get_bake_quality" enum="BakedLightmap.BakeQuality">
+			Three quality modes are available. Higher quality requires more rendering time. See [enum BakeQuality].
 		</member>
 		<member name="capture_cell_size" type="float" setter="set_capture_cell_size" getter="get_capture_cell_size">
+			Grid size used for real-time capture information on dynamic objects. Cannot be larger than [member bake_cell_size].
 		</member>
 		<member name="image_path" type="String" setter="set_image_path" getter="get_image_path">
+			Location where lightmaps will be saved.
 		</member>
 		<member name="light_data" type="BakedLightmapData" setter="set_light_data" getter="get_light_data">
+			The calculated light data.
 		</member>
 	</members>
 	<constants>
 		<constant name="BAKE_QUALITY_LOW" value="0" enum="BakeQuality">
+			Lowest bake quality mode. Fastest to calculate.
 		</constant>
 		<constant name="BAKE_QUALITY_MEDIUM" value="1" enum="BakeQuality">
+			Default bake quality mode.
 		</constant>
 		<constant name="BAKE_QUALITY_HIGH" value="2" enum="BakeQuality">
+			Highest bake quality mode. Takes longer to calculate.
 		</constant>
 		<constant name="BAKE_MODE_CONE_TRACE" value="0" enum="BakeMode">
+			Less precise but faster bake mode.
 		</constant>
 		<constant name="BAKE_MODE_RAY_TRACE" value="1" enum="BakeMode">
+			More precise bake mode but can take considerably longer to bake.
 		</constant>
 		<constant name="BAKE_ERROR_OK" value="0" enum="BakeError">
 		</constant>

doc/classes/DirectionalLight.xml

@@ -1,10 +1,10 @@
 <?xml version="1.0" encoding="UTF-8" ?>
 <class name="DirectionalLight" inherits="Light" category="Core" version="3.1">
 	<brief_description>
-		Directional Light, such as the Sun or the Moon.
+		Directional light from a distance, as from the Sun.
 	</brief_description>
 	<description>
-		A DirectionalLight is a type of [Light] node that emits light constantly in one direction (the negative z axis of the node). It is used lights with strong intensity that are located far away from the scene to model sunlight or moonlight. The worldspace location of the DirectionalLight transform (origin) is ignored, only the basis is used do determine light direction.
+		A directional light is a type of [Light] node that models an infinite number of parallel rays covering the entire scene. It is used for lights with strong intensity that are located far away from the scene to model sunlight or moonlight. The worldspace location of the DirectionalLight transform (origin) is ignored. Only the basis is used do determine light direction.
 	</description>
 	<tutorials>
 		<link>http://docs.godotengine.org/en/3.0/tutorials/3d/lights_and_shadows.html</link>
@@ -15,34 +15,48 @@
 	</methods>
 	<members>
 		<member name="directional_shadow_bias_split_scale" type="float" setter="set_param" getter="get_param">
+			Amount of extra bias for shadow splits that are far away. If self shadowing occurs only on the splits far away, this value can fix them.
 		</member>
 		<member name="directional_shadow_blend_splits" type="bool" setter="set_blend_splits" getter="is_blend_splits_enabled">
+			If [code]true[/code] shadow detail is sacrificed in exchange for smoother transitions between splits. Default value:[code]false[/code].
 		</member>
 		<member name="directional_shadow_depth_range" type="int" setter="set_shadow_depth_range" getter="get_shadow_depth_range" enum="DirectionalLight.ShadowDepthRange">
+			Optimizes shadow rendering for detail versus movement. See [enum ShadowDepthRange].
 		</member>
 		<member name="directional_shadow_max_distance" type="float" setter="set_param" getter="get_param">
+			The maximum distance for shadow splits.
 		</member>
 		<member name="directional_shadow_mode" type="int" setter="set_shadow_mode" getter="get_shadow_mode" enum="DirectionalLight.ShadowMode">
+			The light's shadow rendering algorithm. See [enum ShadowMode].
 		</member>
 		<member name="directional_shadow_normal_bias" type="float" setter="set_param" getter="get_param">
+			Can be used to fix special cases of self shadowing when objects are perpendicular to the light.
 		</member>
 		<member name="directional_shadow_split_1" type="float" setter="set_param" getter="get_param">
+			The distance from camera to shadow split 1. Relative to [member directional_shadow_max_distance]. Only used in [enum directional_shadow_mode] SHADOW_PARALLEL_*_SPLITS.
 		</member>
 		<member name="directional_shadow_split_2" type="float" setter="set_param" getter="get_param">
+			The distance from shadow split 1 to split 2. Relative to [member directional_shadow_max_distance]. Only used in [enum directional_shadow_mode] SHADOW_PARALLEL_*_SPLITS.
 		</member>
 		<member name="directional_shadow_split_3" type="float" setter="set_param" getter="get_param">
+			The distance from shadow split 2 to split 3. Relative to [member directional_shadow_max_distance]. Only used in [enum directional_shadow_mode] SHADOW_PARALLEL_4_SPLITS.
 		</member>
 	</members>
 	<constants>
 		<constant name="SHADOW_ORTHOGONAL" value="0" enum="ShadowMode">
+			Renders the entire scene's shadow map from an orthogonal point of view. May result in blockier shadows on close objects.
 		</constant>
 		<constant name="SHADOW_PARALLEL_2_SPLITS" value="1" enum="ShadowMode">
+			Splits the view frustum in 2 areas, each with its own shadow map.
 		</constant>
 		<constant name="SHADOW_PARALLEL_4_SPLITS" value="2" enum="ShadowMode">
+			Splits the view frustum in 4 areas, each with its own shadow map.
 		</constant>
 		<constant name="SHADOW_DEPTH_RANGE_STABLE" value="0" enum="ShadowDepthRange">
+			Keeps the shadow stable when the camera moves, at the cost of lower effective shadow resolution. Default value.
 		</constant>
 		<constant name="SHADOW_DEPTH_RANGE_OPTIMIZED" value="1" enum="ShadowDepthRange">
+			Tries to achieve maximum shadow resolution. May result in saw effect on shadow edges.
 		</constant>
 	</constants>
 </class>

doc/classes/InputEventKey.xml

@@ -16,6 +16,7 @@
 			<return type="int">
 			</return>
 			<description>
+				Returns the scancode combined with modifier keys such as [code]Shift[/code] or [code]Alt[/code]. See also [InputEventWithModifiers].
 			</description>
 		</method>
 	</methods>

doc/classes/InputMap.xml

@@ -40,6 +40,7 @@
 			<argument index="0" name="action" type="String">
 			</argument>
 			<description>
+				Removes all events from an action.
 			</description>
 		</method>
 		<method name="action_has_event">
@@ -50,7 +51,7 @@
 			<argument index="1" name="event" type="InputEvent">
 			</argument>
 			<description>
-				Returns [true] if an action has an [InputEvent] associated with it.
+				Returns [code]true[/code] if the action has the given [InputEvent] associated with it.
 			</description>
 		</method>
 		<method name="action_set_deadzone">
@@ -71,7 +72,7 @@
 			<argument index="1" name="deadzone" type="float" default="0.5">
 			</argument>
 			<description>
-				Adds an (empty) action to the [code]InputMap[/code], with a configurable [code]deadzone[/code].
+				Adds an empty action to the [code]InputMap[/code] with a configurable [code]deadzone[/code].
 				An [InputEvent] can then be added to this action with [method action_add_event].
 			</description>
 		</method>

doc/classes/KinematicBody2D.xml

@@ -115,6 +115,8 @@
 			<argument index="6" name="floor_max_angle" type="float" default="0.785398">
 			</argument>
 			<description>
+				Moves the body while keeping it attached to slopes. Similar to [me
+				As long as the [code]snap[/code] vector is in contact with the ground, the body will remain attached to the surface. This means you must disable snap in order to jump, for example. You can do this by setting[code]snap[/code] to[code](0, 0)[/code] or by using [method move_and_slide] instead.
 			</description>
 		</method>
 		<method name="test_move">
@@ -136,6 +138,7 @@
 			If the body is at least this close to another body, this body will consider them to be colliding.
 		</member>
 		<member name="motion/sync_to_physics" type="bool" setter="set_sync_to_physics" getter="is_sync_to_physics_enabled">
+			If [code]true[/code] the body's movement will be synchronized to the physics frame. This is useful when animating movement via [AnimationPlayer], for example on moving platforms.
 		</member>
 	</members>
 	<constants>

doc/classes/Light.xml

@@ -15,28 +15,40 @@
 	</methods>
 	<members>
 		<member name="editor_only" type="bool" setter="set_editor_only" getter="is_editor_only">
+			If [code]true[/code] the light only appears in the editor and will not be visible at runtime. Default value:[code]false[/code].
 		</member>
 		<member name="light_bake_mode" type="int" setter="set_bake_mode" getter="get_bake_mode" enum="Light.BakeMode">
+			The light's bake mode. See [enum BakeMode].
 		</member>
 		<member name="light_color" type="Color" setter="set_color" getter="get_color">
+			The light's color.
 		</member>
 		<member name="light_cull_mask" type="int" setter="set_cull_mask" getter="get_cull_mask">
+			The light will affect objects in the selected layers.
 		</member>
 		<member name="light_energy" type="float" setter="set_param" getter="get_param">
+			The light's strength multiplier.
 		</member>
 		<member name="light_indirect_energy" type="float" setter="set_param" getter="get_param">
+			Secondary multiplier used with indirect light (light bounces). This works in baked light or GIProbe.
 		</member>
 		<member name="light_negative" type="bool" setter="set_negative" getter="is_negative">
+			If [code]true[/code] the light's effect is reversed, darkening areas and casting bright shadows. Default value: [code]false[/code].
 		</member>
 		<member name="light_specular" type="float" setter="set_param" getter="get_param">
+			The intensity of the specular blob in objects affected by the light. At [code]0[/code] the light becomes a pure diffuse light.
 		</member>
 		<member name="shadow_bias" type="float" setter="set_param" getter="get_param">
+			Used to adjust shadow appearance. Too small a value results in self shadowing, while too large a value causes shadows to separate from casters. Adjust as needed.
 		</member>
 		<member name="shadow_color" type="Color" setter="set_shadow_color" getter="get_shadow_color">
+			The color of shadows cast by this light.
 		</member>
 		<member name="shadow_contact" type="float" setter="set_param" getter="get_param">
+			Attempts to reduce [member shadow_bias] gap.
 		</member>
 		<member name="shadow_enabled" type="bool" setter="set_shadow" getter="has_shadow">
+			If [code]true[/code] the light will cast shadows. Default value: [code]false[/code].
 		</member>
 		<member name="shadow_reverse_cull_face" type="bool" setter="set_shadow_reverse_cull_face" getter="get_shadow_reverse_cull_face">
 		</member>
@@ -75,10 +87,13 @@
 		<constant name="PARAM_MAX" value="15" enum="Param">
 		</constant>
 		<constant name="BAKE_DISABLED" value="0" enum="BakeMode">
+			Light is ignored when baking. Note: hiding a light does [i]not[/i] affect baking.
 		</constant>
 		<constant name="BAKE_INDIRECT" value="1" enum="BakeMode">
+			Only indirect lighting will be baked. Default value.
 		</constant>
 		<constant name="BAKE_ALL" value="2" enum="BakeMode">
+			Both direct and indirect light will be baked. Note: you should hide the light if you don't want it to appear twice (dynamic and baked).
 		</constant>
 	</constants>
 </class>

doc/classes/OmniLight.xml

@@ -1,10 +1,10 @@
 <?xml version="1.0" encoding="UTF-8" ?>
 <class name="OmniLight" inherits="Light" category="Core" version="3.1">
 	<brief_description>
-		OmniDirectional Light, such as a light bulb or a candle.
+		Omnidirectional light, such as a light bulb or a candle.
 	</brief_description>
 	<description>
-		An OmniDirectional light is a type of [Light] node that emits lights in all directions. The light is attenuated through the distance and this attenuation can be configured by changing the energy, radius and attenuation parameters of [Light].
+		An Omnidirectional light is a type of [Light] that emits light in all directions. The light is attenuated by distance and this attenuation can be configured by changing its energy, radius, and attenuation parameters.
 	</description>
 	<tutorials>
 		<link>http://docs.godotengine.org/en/3.0/tutorials/3d/lights_and_shadows.html</link>
@@ -15,12 +15,16 @@
 	</methods>
 	<members>
 		<member name="omni_attenuation" type="float" setter="set_param" getter="get_param">
+			The light's attenuation (drop-off) curve. A number of presets are available in the Inspector.
 		</member>
 		<member name="omni_range" type="float" setter="set_param" getter="get_param">
+			Maximum distance the light affects.
 		</member>
 		<member name="omni_shadow_detail" type="int" setter="set_shadow_detail" getter="get_shadow_detail" enum="OmniLight.ShadowDetail">
+			See [enum ShadowDetail].
 		</member>
 		<member name="omni_shadow_mode" type="int" setter="set_shadow_mode" getter="get_shadow_mode" enum="OmniLight.ShadowMode">
+			See [enum ShadowMode].
 		</member>
 	</members>
 	<constants>

doc/classes/ProgressBar.xml

@@ -14,6 +14,7 @@
 	</methods>
 	<members>
 		<member name="percent_visible" type="bool" setter="set_percent_visible" getter="is_percent_visible">
+			If [code]true[/code] the fill percentage is displayed on the bar. Default value: [code]true[/code].
 		</member>
 	</members>
 	<constants>

doc/classes/Range.xml

@@ -17,30 +17,32 @@
 			<argument index="0" name="with" type="Node">
 			</argument>
 			<description>
-				Binds two Ranges together along with any Ranges previously grouped with either of them. When any of Range's member variables change, it will share the new value with all other Ranges in its group.
+				Binds two ranges together along with any ranges previously grouped with either of them. When any of range's member variables change, it will share the new value with all other ranges in its group.
 			</description>
 		</method>
 		<method name="unshare">
 			<return type="void">
 			</return>
 			<description>
-				Stop Range from sharing its member variables with any other Range.
+				Stop range from sharing its member variables with any other.
 			</description>
 		</method>
 	</methods>
 	<members>
 		<member name="allow_greater" type="bool" setter="set_allow_greater" getter="is_greater_allowed">
+			If [code]true[/code] [member value] may be greater than [member max_value]. Default value: [code]false[/code].
 		</member>
 		<member name="allow_lesser" type="bool" setter="set_allow_lesser" getter="is_lesser_allowed">
+			If [code]true[/code] [member value] may be less than [member min_value]. Default value: [code]false[/code].
 		</member>
 		<member name="exp_edit" type="bool" setter="set_exp_ratio" getter="is_ratio_exp">
 			If [code]true[/code] and [code]min_value[/code] is greater than 0, [code]value[/code] will be represented exponentially rather than linearly.
 		</member>
 		<member name="max_value" type="float" setter="set_max" getter="get_max">
-			Maximum value. Range is clamped if [code]value[/code] is greater than [code]max_value[/code]. Default value: 100.
+			Maximum value. Range is clamped if [code]value[/code] is greater than [code]max_value[/code]. Default value: [code]100[/code].
 		</member>
 		<member name="min_value" type="float" setter="set_min" getter="get_min">
-			Minimum value. Range is clamped if [code]value[/code] is less than [code]min_value[/code]. Default value: 0.
+			Minimum value. Range is clamped if [code]value[/code] is less than [code]min_value[/code]. Default value: [code]0[/code].
 		</member>
 		<member name="page" type="float" setter="set_page" getter="get_page">
 			Page size. Used mainly for [ScrollBar]. ScrollBar's length is its size multiplied by [code]page[/code] over the difference between [code]min_value[/code] and [code]max_value[/code].
@@ -49,7 +51,7 @@
 			The value mapped between 0 and 1.
 		</member>
 		<member name="rounded" type="bool" setter="set_use_rounded_values" getter="is_using_rounded_values">
-			If [code]true[/code], [code]value[/code] will always be rounded to the nearest integer.
+			If [code]true[/code] [code]value[/code] will always be rounded to the nearest integer. Default value: [code]false[/code].
 		</member>
 		<member name="step" type="float" setter="set_step" getter="get_step">
 			If greater than 0, [code]value[/code] will always be rounded to a multiple of [code]step[/code]. If [code]rounded[/code] is also [code]true[/code], [code]value[/code] will first be rounded to a multiple of [code]step[/code] then rounded to the nearest integer.
@@ -61,14 +63,14 @@
 	<signals>
 		<signal name="changed">
 			<description>
-				This signal is emitted when min, max, range or step change.
+				Emitted when [member min_value], [member max_value], [member page], or [member step] change.
 			</description>
 		</signal>
 		<signal name="value_changed">
 			<argument index="0" name="value" type="float">
 			</argument>
 			<description>
-				This signal is emitted when value changes.
+				Emitted when [member value] changes.
 			</description>
 		</signal>
 	</signals>

doc/classes/TileSet.xml

@@ -58,7 +58,7 @@
 			<return type="void">
 			</return>
 			<description>
-				Clear all tiles.
+				Clears all tiles.
 			</description>
 		</method>
 		<method name="create_tile">
@@ -67,7 +67,7 @@
 			<argument index="0" name="id" type="int">
 			</argument>
 			<description>
-				Create a new tile which will be referenced by the given ID.
+				Creates a new tile which will be referenced by the given ID.
 			</description>
 		</method>
 		<method name="find_tile_by_name" qualifiers="const">
@@ -76,21 +76,21 @@
 			<argument index="0" name="name" type="String">
 			</argument>
 			<description>
-				Find the first tile matching the given name.
+				Returns the first tile matching the given name.
 			</description>
 		</method>
 		<method name="get_last_unused_tile_id" qualifiers="const">
 			<return type="int">
 			</return>
 			<description>
-				Return the ID following the last currently used ID, useful when creating a new tile.
+				Returns the ID following the last currently used ID, useful when creating a new tile.
 			</description>
 		</method>
 		<method name="get_tiles_ids" qualifiers="const">
 			<return type="Array">
 			</return>
 			<description>
-				Return an array of all currently used tile IDs.
+				Returns an array of all currently used tile IDs.
 			</description>
 		</method>
 		<method name="remove_tile">
@@ -99,7 +99,7 @@
 			<argument index="0" name="id" type="int">
 			</argument>
 			<description>
-				Remove the tile referenced by the given ID.
+				Removes the tile referenced by the given ID.
 			</description>
 		</method>
 		<method name="tile_add_shape">
@@ -124,7 +124,7 @@
 			<argument index="0" name="id" type="int">
 			</argument>
 			<description>
-				Return the light occluder of the tile.
+				Returns the light occluder of the tile.
 			</description>
 		</method>
 		<method name="tile_get_material" qualifiers="const">
@@ -133,7 +133,7 @@
 			<argument index="0" name="id" type="int">
 			</argument>
 			<description>
-				Return the material of the tile.
+				Returns the material of the tile.
 			</description>
 		</method>
 		<method name="tile_get_modulate" qualifiers="const">
@@ -150,7 +150,7 @@
 			<argument index="0" name="id" type="int">
 			</argument>
 			<description>
-				Return the name of the tile.
+				Returns the name of the tile.
 			</description>
 		</method>
 		<method name="tile_get_navigation_polygon" qualifiers="const">
@@ -159,7 +159,7 @@
 			<argument index="0" name="id" type="int">
 			</argument>
 			<description>
-				Return the navigation polygon of the tile.
+				Returns the navigation polygon of the tile.
 			</description>
 		</method>
 		<method name="tile_get_navigation_polygon_offset" qualifiers="const">
@@ -168,7 +168,7 @@
 			<argument index="0" name="id" type="int">
 			</argument>
 			<description>
-				Return the offset of the tile's navigation polygon.
+				Returns the offset of the tile's navigation polygon.
 			</description>
 		</method>
 		<method name="tile_get_normal_map" qualifiers="const">
@@ -185,7 +185,7 @@
 			<argument index="0" name="id" type="int">
 			</argument>
 			<description>
-				Return the offset of the tile's light occluder.
+				Returns the offset of the tile's light occluder.
 			</description>
 		</method>
 		<method name="tile_get_region" qualifiers="const">
@@ -194,7 +194,7 @@
 			<argument index="0" name="id" type="int">
 			</argument>
 			<description>
-				Return the tile sub-region in the texture.
+				Returns the tile sub-region in the texture.
 			</description>
 		</method>
 		<method name="tile_get_shape" qualifiers="const">
@@ -241,7 +241,7 @@
 			<argument index="0" name="id" type="int">
 			</argument>
 			<description>
-				Return the array of shapes of the tile.
+				Returns the array of shapes of the tile.
 			</description>
 		</method>
 		<method name="tile_get_texture" qualifiers="const">
@@ -250,7 +250,7 @@
 			<argument index="0" name="id" type="int">
 			</argument>
 			<description>
-				Return the texture of the tile.
+				Returns the texture of the tile.
 			</description>
 		</method>
 		<method name="tile_get_texture_offset" qualifiers="const">
@@ -259,7 +259,7 @@
 			<argument index="0" name="id" type="int">
 			</argument>
 			<description>
-				Return the texture offset of the tile.
+				Returns the texture offset of the tile.
 			</description>
 		</method>
 		<method name="tile_get_tile_mode" qualifiers="const">
@@ -286,7 +286,7 @@
 			<argument index="1" name="light_occluder" type="OccluderPolygon2D">
 			</argument>
 			<description>
-				Set a light occluder for the tile.
+				Sets a light occluder for the tile.
 			</description>
 		</method>
 		<method name="tile_set_material">
@@ -297,7 +297,7 @@
 			<argument index="1" name="material" type="ShaderMaterial">
 			</argument>
 			<description>
-				Set the material of the tile.
+				Sets the tile's material.
 			</description>
 		</method>
 		<method name="tile_set_modulate">
@@ -308,6 +308,7 @@
 			<argument index="1" name="color" type="Color">
 			</argument>
 			<description>
+				Sets the tile's modulation color.
 			</description>
 		</method>
 		<method name="tile_set_name">
@@ -318,7 +319,7 @@
 			<argument index="1" name="name" type="String">
 			</argument>
 			<description>
-				Set the name of the tile, for descriptive purposes.
+				Sets the tile's name.
 			</description>
 		</method>
 		<method name="tile_set_navigation_polygon">
@@ -329,7 +330,7 @@
 			<argument index="1" name="navigation_polygon" type="NavigationPolygon">
 			</argument>
 			<description>
-				Set a navigation polygon for the tile.
+				Sets the tile's navigation polygon.
 			</description>
 		</method>
 		<method name="tile_set_navigation_polygon_offset">
@@ -340,7 +341,7 @@
 			<argument index="1" name="navigation_polygon_offset" type="Vector2">
 			</argument>
 			<description>
-				Set an offset for the tile's navigation polygon.
+				Sets an offset for the tile's navigation polygon.
 			</description>
 		</method>
 		<method name="tile_set_normal_map">
@@ -351,6 +352,7 @@
 			<argument index="1" name="normal_map" type="Texture">
 			</argument>
 			<description>
+				Sets the tile's normal map texture.
 			</description>
 		</method>
 		<method name="tile_set_occluder_offset">
@@ -372,7 +374,7 @@
 			<argument index="1" name="region" type="Rect2">
 			</argument>
 			<description>
-				Set the tile sub-region in the texture. This is common in texture atlases.
+				Set the tile's sub-region in the texture. This is common in texture atlases.
 			</description>
 		</method>
 		<method name="tile_set_shape">
@@ -419,7 +421,7 @@
 			<argument index="1" name="shapes" type="Array">
 			</argument>
 			<description>
-				Set an array of shapes for the tile, enabling physics to collide with it.
+				Sets an array of shapes for the tile, enabling collision.
 			</description>
 		</method>
 		<method name="tile_set_texture">
@@ -430,7 +432,7 @@
 			<argument index="1" name="texture" type="Texture">
 			</argument>
 			<description>
-				Set the texture of the tile.
+				Sets the tile's texture.
 			</description>
 		</method>
 		<method name="tile_set_texture_offset">
@@ -441,7 +443,7 @@
 			<argument index="1" name="texture_offset" type="Vector2">
 			</argument>
 			<description>
-				Set the texture offset of the tile.
+				Sets the tile's texture offset.
 			</description>
 		</method>
 		<method name="tile_set_tile_mode">
@@ -452,6 +454,7 @@
 			<argument index="1" name="tilemode" type="int" enum="TileSet.TileMode">
 			</argument>
 			<description>
+				Sets the tile's [enum TileMode].
 			</description>
 		</method>
 		<method name="tile_set_z_index">
@@ -462,6 +465,7 @@
 			<argument index="1" name="z_index" type="int">
 			</argument>
 			<description>
+				Sets the tile's drawing index.
 			</description>
 		</method>
 	</methods>

doc/classes/Viewport.xml

@@ -22,35 +22,35 @@
 			<return type="World">
 			</return>
 			<description>
-				Return the 3D world of the viewport, or if no such present, the one of the parent viewport.
+				Returns the 3D world of the viewport, or if none the world of the parent viewport.
 			</description>
 		</method>
 		<method name="find_world_2d" qualifiers="const">
 			<return type="World2D">
 			</return>
 			<description>
-				Return the 2D world of the viewport.
+				Returns the 2D world of the viewport.
 			</description>
 		</method>
 		<method name="get_camera" qualifiers="const">
 			<return type="Camera">
 			</return>
 			<description>
-				Return the active 3D camera.
+				Returns the active 3D camera.
 			</description>
 		</method>
 		<method name="get_final_transform" qualifiers="const">
 			<return type="Transform2D">
 			</return>
 			<description>
-				Get the total transform of the viewport.
+				Returns the total transform of the viewport.
 			</description>
 		</method>
 		<method name="get_mouse_position" qualifiers="const">
 			<return type="Vector2">
 			</return>
 			<description>
-				Get the mouse position, relative to the viewport.
+				Returns the mouse position relative to the viewport.
 			</description>
 		</method>
 		<method name="get_render_info">
@@ -59,35 +59,35 @@
 			<argument index="0" name="info" type="int" enum="Viewport.RenderInfo">
 			</argument>
 			<description>
-				Get the specific information about the viewport from rendering pipeline.
+				Returns information about the viewport from the rendering pipeline.
 			</description>
 		</method>
 		<method name="get_size_override" qualifiers="const">
 			<return type="Vector2">
 			</return>
 			<description>
-				Get the size override set with [method set_size_override].
+				Returns the size override set with [method set_size_override].
 			</description>
 		</method>
 		<method name="get_texture" qualifiers="const">
 			<return type="ViewportTexture">
 			</return>
 			<description>
-				Get the viewport's texture, for use with various objects that you want to texture with the viewport.
+				Returns the viewport's texture.
 			</description>
 		</method>
 		<method name="get_viewport_rid" qualifiers="const">
 			<return type="RID">
 			</return>
 			<description>
-				Get the viewport RID from the [VisualServer].
+				Returns the viewport's RID from the [VisualServer].
 			</description>
 		</method>
 		<method name="get_visible_rect" qualifiers="const">
 			<return type="Rect2">
 			</return>
 			<description>
-				Return the final, visible rect in global screen coordinates.
+				Returns the visible rectangle in global screen coordinates.
 			</description>
 		</method>
 		<method name="gui_get_drag_data" qualifiers="const">
@@ -101,7 +101,7 @@
 			<return type="bool">
 			</return>
 			<description>
-				Returns whether there are shown modals on-screen.
+				Returns [code]true[/code] if there are visible modals on-screen.
 			</description>
 		</method>
 		<method name="input">
@@ -116,14 +116,14 @@
 			<return type="bool">
 			</return>
 			<description>
-				Get the enabled status of the size override set with [method set_size_override].
+				Returns [code]true[/code] if the size override is enabled. See [method set_size_override].
 			</description>
 		</method>
 		<method name="is_size_override_stretch_enabled" qualifiers="const">
 			<return type="bool">
 			</return>
 			<description>
-				Get the enabled status of the size stretch override set with [method set_size_override_stretch].
+				Returns [code]true[/code] if the size stretch override is enabled. See [method set_size_override_stretch].
 			</description>
 		</method>
 		<method name="set_attach_to_screen_rect">
@@ -144,7 +144,7 @@
 			<argument index="2" name="margin" type="Vector2" default="Vector2( 0, 0 )">
 			</argument>
 			<description>
-				Set the size override of the viewport. If the enable parameter is true, it would use the override, otherwise it would use the default size. If the size parameter is equal to [code](-1, -1)[/code], it won't update the size.
+				Sets the size override of the viewport. If the [code]enable[/code] parameter is [code]true[/code] the override is used, otherwise it uses the default size. If the size parameter is [code](-1, -1)[/code], it won't update the size.
 			</description>
 		</method>
 		<method name="set_size_override_stretch">
@@ -153,7 +153,7 @@
 			<argument index="0" name="enabled" type="bool">
 			</argument>
 			<description>
-				Set whether the size override affects stretch as well.
+				If [code]true[/code] the size override affects stretch as well.
 			</description>
 		</method>
 		<method name="unhandled_input">
@@ -168,7 +168,7 @@
 			<return type="void">
 			</return>
 			<description>
-				Force update of the 2D and 3D worlds.
+				Forces update of the 2D and 3D worlds.
 			</description>
 		</method>
 		<method name="warp_mouse">
@@ -177,7 +177,7 @@
 			<argument index="0" name="to_position" type="Vector2">
 			</argument>
 			<description>
-				Warp the mouse to a position, relative to the viewport.
+				Warps the mouse to a position relative to the viewport.
 			</description>
 		</method>
 	</methods>