Move remaining files out of step_by_step/

Moved those to scripting/:

- filesystem
- resources
- singletons_autoload
- scene_tree

export to export/

and godot_design_philosophy to introduction/

about/docs_changelog.rst

@@ -107,7 +107,7 @@ Step by step
 ^^^^^^^^^^^^
 
 - :ref:`doc_signals`
-- :ref:`doc_exporting`
+- :ref:`doc_exporting_basics`
 
 Scripting
 ^^^^^^^^^

classes/class_directory.rst

@@ -43,7 +43,7 @@ Here is an example on how to iterate through the files of a directory:
 Tutorials
 ---------
 
-- :doc:`../getting_started/step_by_step/filesystem`
+- :doc:`../tutorials/scripting/filesystem`
 
 Methods
 -------

classes/class_file.rst

@@ -44,7 +44,7 @@ In the example above, the file will be saved in the user data folder as specifie
 Tutorials
 ---------
 
-- :doc:`../getting_started/step_by_step/filesystem`
+- :doc:`../tutorials/scripting/filesystem`
 
 - `3D Voxel Demo <https://godotengine.org/asset-library/asset/676>`__
 

classes/class_resource.rst

@@ -25,7 +25,7 @@ Resource is the base class for all Godot-specific resource types, serving primar
 Tutorials
 ---------
 
-- :doc:`../getting_started/step_by_step/resources`
+- :doc:`../tutorials/scripting/resources`
 
 - :doc:`../getting_started/workflow/best_practices/node_alternatives`
 

classes/class_scenetree.rst

@@ -25,7 +25,7 @@ You can also use the ``SceneTree`` to organize your nodes into groups: every nod
 Tutorials
 ---------
 
-- :doc:`../getting_started/step_by_step/scene_tree`
+- :doc:`../tutorials/scripting/scene_tree`
 
 - :doc:`../tutorials/rendering/multiple_resolutions`
 

getting_started/introduction/index.rst

@@ -0,0 +1,24 @@
+.. Intention: provide the necessary information to make the most of the getting
+   started series, answering questions like "do I want to learn Godot?", "how
+   does it look and feel?", "how does it work?", and "how do I best learn it?".
+
+Introduction
+============
+
+This series will introduce you to Godot and give you an overview of its
+features.
+
+In the following pages, you will get answers to questions such as "Is Godot for
+me?" or "What can I do with Godot?". We will then introduce the engine's most
+essential concepts, run you through the editor's interface, and give you tips to
+make the most of your time learning it.
+
+.. toctree::
+   :maxdepth: 1
+   :name: toc-learn-introduction
+
+   introduction_to_godot
+   key_concepts_overview
+   first_look_at_the_editor
+   learning_new_features
+   godot_design_philosophy

getting_started/introduction/introduction_to_godot.rst

@@ -0,0 +1,128 @@
+.. _doc_introduction_to_godot:
+
+Introduction to Godot
+=====================
+
+This article is here to help you figure out whether Godot might be a good fit
+for you. We will introduce some broad features of the engine to give you a feel
+for what you can achieve with it and answer questions such as "what do I need to
+know to get started?".
+
+This is by no means an exhaustive overview. We will introduce many more features
+in this getting started series.
+
+What is Godot?
+--------------
+
+Godot is a general-purpose 2D and 3D game engine designed to support all sorts
+of projects. You can use it to create games or applications you can then release
+on desktop or mobile, as well as on the web.
+
+You can also create console games with it, although you either need strong
+programming skills or a developer to port the game for you.
+
+.. note:: The Godot team can't provide an open-source console export due to the
+          licensing terms imposed by console manufacturers. Regardless of the
+          engine you use, though, releasing games on consoles is always a lot of
+          work. You can read more on that here: :ref:`doc_consoles`.
+
+What can the engine do?
+-----------------------
+
+Godot was initially developed in-house by an Argentinan game studio. Its
+development started in 2001, and the engine was rewritten and improved
+tremendously since its open-source release in 2014.
+
+Some examples of games created with Godot include Ex-Zodiac and Helms of Fury.
+
+.. image:: img/introduction_ex_zodiac.png
+
+.. image:: img/introduction_helms_of_fury.jpg
+
+As for applications, the open-source pixel art drawing program Pixelorama is
+powered by Godot, and so is the voxel RPG creator RPG in a box.
+
+.. image:: img/introduction_rpg_in_a_box.png
+
+You can find many more examples in the official showcase videos:
+
+- `April 2020 desktop and console showcase`_
+- `April 2020 mobile showcase`_
+
+How does it work and look?
+--------------------------
+
+Godot comes with a fully-fledged game editor with integrated tools to answer the
+most common needs. It includes a code editor, an animation editor, a tilemap
+editor, a shader editor, a debugger, a profiler, and more.
+
+.. image:: img/introduction_editor.png
+
+The team strives to offer a feature-rich game editor with a consistent user
+experience. While there is always room for improvement, the user interface keeps
+getting refined.
+
+Of course, if you prefer, you can work with external programs. We officially
+support importing 3D scenes designed in Blender_ and maintain plugins to code in
+VSCode_ and Emacs_ for GDScript and C#. We also support Visual Studio for C# on
+Windows.
+
+.. image:: img/introduction_vscode.png
+
+Programming languages
+---------------------
+
+Let's talk about the available programming languages.
+
+You can code your games using :ref:`GDScript <toc-learn-scripting-gdscript>`, a
+Godot-specific and tightly integrated language with a lightweight syntax, or
+:ref:`C# <toc-learn-scripting-C#>`, which is popular in the games industry.
+These are the two main scripting languages we support.
+
+Godot also supports a node-based visual programming language named
+:ref:`VisualScript <toc-learn-scripting-visual_script>`.
+
+With the :ref:`GDNative <toc-tutorials-gdnative>` technology, you can also write
+gameplay or high-performance algorithms in C or C++ without recompiling the
+engine. You can use this technology to integrate third-party libraries and other
+Software Development Kits (SDK) in the engine.
+
+Of course, you can also directly add modules and features to the engine, as it's
+completely free and open-source.
+
+.. seealso:: These are the five officially supported programming languages. The
+             community maintains support for many more. For more information,
+             see :ref:`GDNative third-party bindings
+             <doc_what_is_gdnative_third_party_bindings>`.
+
+What do I need to know to use Godot?
+------------------------------------
+
+Godot is a feature-packed game engine. With its thousands of features, there is
+a lot to learn. To make the most of it, you need good programming foundations.
+While we try to make the engine accessible, you will benefit a lot from knowing
+how to think like a programmer first.
+
+Godot relies on the object-oriented programming paradigm. Being comfortable with
+concepts such as classes and objects will help you code efficiently in it.
+
+If you are entirely new to programming, we recommend following the `CS50 open
+courseware`_ from Harvard University. It's a great free course that will teach
+you everything you need to know to be off to a good start. It will save you
+countless hours and hurdles learning any game engine afterward.
+
+.. note:: In CS50, you will learn multiple programming languages. Don't be
+          afraid of that: programming languages have many similarities. The
+          skills you learn with one language transfer well to others.
+
+We will provide you with more Godot-specific learning resources in
+:ref:`doc_learning_new_features`.
+
+In the next part, you will get an overview of the engine's essential concepts.
+
+.. _Blender: https://www.blender.org/
+.. _VSCode: https://github.com/godotengine/godot-vscode-plugin
+.. _Emacs: https://github.com/godotengine/emacs-gdscript-mode
+.. _April 2020 desktop and console showcase: https://youtu.be/UEDEIksGEjQ
+.. _April 2020 mobile showcase: https://youtu.be/AIapugketbs
+.. _CS50 open courseware: https://cs50.harvard.edu/x/2020/

getting_started/step_by_step/godot_design_philosophy.rst

@@ -3,7 +3,7 @@
 Godot's design philosophy
 =========================
 
-Now that you've gotten your hands wet, let's talk about Godot's design.
+Now that you've gotten your feet wet, let's talk about Godot's design.
 
 **Every game engine is different and fits different needs.**
 Not only do they offer a range of features, but the design of each engine
@@ -16,7 +16,7 @@ is it an engine comparison. To know if any engine can be a good fit for
 your project, you need to try it out for yourself and
 understand its design and limitations.
 
-Please watch `Discover Godot 3, the Free game engine <https://youtu.be/4v3qge-3CqQ>`_
+Please watch `Godot explained in 5 minutes <https://youtu.be/4v3qge-3CqQ>`_
 if you're looking for an overview of the engine's features.
 
 Object-oriented design and composition

getting_started/step_by_step/index.rst

@@ -12,15 +12,3 @@ Step by step
    scripting
    signals
    your_first_game
-   exporting
-   godot_design_philosophy
-   ui_introduction_to_the_ui_system
-   ui_main_menu
-   ui_game_user_interface
-   ui_code_a_life_bar
-   splash_screen
-   animations
-   resources
-   filesystem
-   scene_tree
-   singletons_autoload

getting_started/step_by_step/exporting.rst → tutorials/export/exporting_basics.rst

@@ -1,4 +1,4 @@
-.. _doc_exporting:
+.. _doc_exporting_basics:
 
 Exporting
 =========

tutorials/export/index.rst

@@ -5,7 +5,7 @@ Export
    :maxdepth: 1
    :name: toc-learn-workflow-export
 
-
+   exporting_basics
    exporting_projects
    exporting_pcks
    feature_tags

tutorials/scripting/index.rst

@@ -30,6 +30,8 @@ Some features are specific to the engine and are available in all supported
 languages. Whether you code in GDScript, C#, or another language, the pages
 below will help you make the most of Godot.
 
+.. To split and organize better, into some related toctrees?
+
 .. toctree::
    :maxdepth: 1
    :name: toc-scripting-core-features
@@ -44,3 +46,7 @@ below will help you make the most of Godot.
    change_scenes_manually
    instancing_with_signals
    pausing_games
+   filesystem
+   resources
+   singletons_autoload
+   scene_tree