From b4fdd2b1207eb1f2d4065d43b373715c37cdf498 Mon Sep 17 00:00:00 2001 From: clayjohn Date: Wed, 13 Mar 2019 23:15:45 -0700 Subject: [PATCH 001/154] add basic changelog for docs --- about/docs_changelog.rst | 130 +++++++++++++++++++++++++++++++++++++++ about/index.rst | 1 + 2 files changed, 131 insertions(+) create mode 100644 about/docs_changelog.rst diff --git a/about/docs_changelog.rst b/about/docs_changelog.rst new file mode 100644 index 000000000..adf7a16ed --- /dev/null +++ b/about/docs_changelog.rst @@ -0,0 +1,130 @@ +.. _doc_docs_changelog: + +Documentation changelog +======================= + +The documentation is continually being improved. The release of version 3.1 +includes many new tutorials, many fixes and updates for old tutorials, and many updates +to the class reference. Below is a list of new tutorials added since version 3.0. + +.. note:: This document only contains new tutorials so not all changes are reflected, + many tutorials have been substantially updated but are not reflected in this document. + +New tutorials since version 3.0 +------------------------------- + +Step-by-step +^^^^^^^^^^^^ + +- :ref:`Signals ` +- :ref:`Exporting ` + +Project workflow +^^^^^^^^^^^^^^^^ +Best Practices: + - :ref:`Introduction ` + - :ref:`What are Godot classes ` + - :ref:`Scene organization ` + - :ref:`Scenes versus scripts ` + - :ref:`Autoloads versus internal nodes ` + - :ref:`Node alternatives ` + - :ref:`Godot interfaces ` + - :ref:`Godot notifications ` + - :ref:`Data preferences ` + - :ref:`Logic preferences ` + +Scripting +^^^^^^^^^ + +- :ref:`Typed GDscript ` + +2D +^^ + +- :ref:`2D lights and shadows ` +- :ref:`2D meshes ` + +3D +^^ + +- :ref:`CSG ` +- :ref:`Animating thousands of fish with MultiMesh ` +- :ref:`Controlling thousands of fish with Particles ` + +Physics +^^^^^^^ + +- :ref:`Ragdoll system ` +- :ref:`Softbody ` + +Animation +^^^^^^^^^ + +- :ref:`2D skeletons ` +- :ref:`AnimationTree ` + +Viewports +^^^^^^^^^ + +- :ref:`Using a Viewport as a texture ` +- :ref:`Custom post-processing ` + +Shading +^^^^^^^ + +- :ref:`Intro to shaders: 2D and 3D water (7 video tutorials) ` +- :ref:`Migrating to Godot’s shading language ` +- :ref:`Vertex displacement with shaders ` +- :ref:`Advanced post-processing ` + +Shading Reference: + - :ref:`Shaders ` + - :ref:`Shading language ` + - :ref:`Spatial shaders ` + - :ref:`CanvasItem shaders ` + - :ref:`Particles shaders ` + +VR +^^ + +- :ref:`VR starter tutorial ` + +Platform-specific +^^^^^^^^^^^^^^^^^ + +- :ref:`Customizing the Web export HTML page ` + +Multi-threading +^^^^^^^^^^^^^^^ + +- :ref:`Thread safe APIs ` + +Miscellaneous +^^^^^^^^^^^^^ + +- :ref:`Fixing jitter and stutter ` +- :ref:`Running code in the editor ` +- :ref:`Change scenes manually ` +- :ref:`Differences between GLES2 and GLES3 ` + +Compiling +^^^^^^^^^ + +- :ref:`Optimizing a build for size ` +- :ref:`Compiling with script encryption key ` + +Engine development +^^^^^^^^^^^^^^^^^^ + +- :ref:`Binding to external libraries ` + +Creating content +^^^^^^^^^^^^^^^^ + +- :ref:`Making trees ` + +Plugins +^^^^^^^ + +- :ref:`Making main screen plugins ` +- :ref:`Spatial gizmo plugins ` diff --git a/about/index.rst b/about/index.rst index 7304ac7ff..355c022b6 100644 --- a/about/index.rst +++ b/about/index.rst @@ -7,6 +7,7 @@ About introduction faq + docs_changelog .. history .. authors From d1fa43f9d491bbdea67e2209306949ebb293cb2f Mon Sep 17 00:00:00 2001 From: clayjohn Date: Thu, 14 Mar 2019 17:40:12 -0700 Subject: [PATCH 002/154] fixed typo in title of fish tutorial --- tutorials/3d/vertex_animation/animating_thousands_of_fish.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/tutorials/3d/vertex_animation/animating_thousands_of_fish.rst b/tutorials/3d/vertex_animation/animating_thousands_of_fish.rst index cfd4f7429..190060540 100644 --- a/tutorials/3d/vertex_animation/animating_thousands_of_fish.rst +++ b/tutorials/3d/vertex_animation/animating_thousands_of_fish.rst @@ -1,7 +1,7 @@ .. _doc_animating_thousands_of_fish: -Animating thousands of fish with MeshInstance -============================================= +Animating thousands of fish with MultiMeshInstance +================================================== This tutorial explores a technique used in the game `ABZU `_ for rendering and animating thousands of fish using vertex animation and From 1ee685337e5d8f9474adc9a3b1c011b15344b160 Mon Sep 17 00:00:00 2001 From: Arman <48544263+puchik@users.noreply.github.com> Date: Fri, 15 Mar 2019 00:31:28 -0700 Subject: [PATCH 003/154] Edit first paragraph under "Light nodes" (#2245) * Edit first paragraph under "Light nodes" Edited the first paragraph under "Light nodes" for concision. Removed the first part of the second sentence. Instead of noting that lights are discussed later in the article, added internal links. * Grammar fixes in Threadsafe APIs Edited structure of the first and third sentences to improve flow. Corrected "multi threading" to "multithreading" * Revert "Grammar fixes in Threadsafe APIs" This reverts commit 696a05420f655dfd551c0205e0be78eb5a143d3b. --- tutorials/3d/lights_and_shadows.rst | 7 +++---- 1 file changed, 3 insertions(+), 4 deletions(-) diff --git a/tutorials/3d/lights_and_shadows.rst b/tutorials/3d/lights_and_shadows.rst index e11e5321a..9d6a72f5a 100644 --- a/tutorials/3d/lights_and_shadows.rst +++ b/tutorials/3d/lights_and_shadows.rst @@ -22,10 +22,9 @@ in the :ref:`doc_spatial_material` tutorial. Light nodes ----------- -As mentioned before, there are three types of light nodes: Directional, -Omni and Spot. Each has different uses and will be described in -detail below, but first let's take a look at the common parameters for -lights: +There are three types of light nodes: `Directional light`_, +`Omni light`_ and `Spot light`_. Let's take a look at the common +parameters for lights: .. image:: img/light_params.png From 37e18bb5cd7caa221061c6b7d3987193e8e755b5 Mon Sep 17 00:00:00 2001 From: Azumgi <4zumgi@gmail.com> Date: Sat, 16 Mar 2019 00:01:40 +0300 Subject: [PATCH 004/154] Fix several C# code errors --- getting_started/step_by_step/your_first_game.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/getting_started/step_by_step/your_first_game.rst b/getting_started/step_by_step/your_first_game.rst index 5faff3282..3b28d05cc 100644 --- a/getting_started/step_by_step/your_first_game.rst +++ b/getting_started/step_by_step/your_first_game.rst @@ -1037,7 +1037,7 @@ show the "Start" button. public void UpdateScore(int score) { - GetNode