Merge pull request #1028 from mhilbrunner/docs-structure

Restructuring update

community/channels.rst

@@ -0,0 +1,46 @@
+.. _doc_community_channels:
+
+Channels
+========
+
+So, where is the Godot community and where can you ask questions and get help?
+
+Note that some of these channels are run and moderated by members of the Godot community or third parties.
+
+A brief overview over these channels is also available on the `website <https://godotengine.org/community>`_.
+
+Q & A
+-----
+
+- `Official Godot Questions & Answers <https://godotengine.org/qa/>`_
+
+IRC on Freenode
+---------------
+
+- `General: #godotengine <http://webchat.freenode.net/?channels=#godotengine>`_
+- `Engine development: #godotengine-devel <http://webchat.freenode.net/?channels=#godotengine-devel>`_
+- `Documentation: #godotengine-doc <http://webchat.freenode.net/?channels=#godotengine-doc>`_
+- `GDNative: #godotengine-gdnative <http://webchat.freenode.net/?channels=#godotengine-gdnative>`_
+- `Webseite/PR: #godotengine-atelier <http://webchat.freenode.net/?channels=#godotengine-atelier>`_
+- `IRC logs <https://godot.eska.me/irc-logs/>`_
+
+Other chats
+-----------
+
+- `Matrix (IRC compatible) <https://matrix.to/#/#godotengine:matrix.org>`_
+- `Discord <https://discord.gg/zH7NUgz>`_
+
+Social networks
+---------------
+
+- `GitHub <https://github.com/godotengine/>`_
+- `Facebook group <https://www.facebook.com/groups/godotengine/>`_
+- `Twitter (also, #godotengine) <https://twitter.com/godotengine>`_
+- `Reddit <https://www.reddit.com/r/godot>`_
+- `Youtube <https://www.youtube.com/c/GodotEngineOfficial>`_
+- `Steam <https://steamcommunity.com/app/404790>`_
+
+Forum
+-----
+
+- `Forum (godotdevelopers.org) <http://godotdevelopers.org/>`_

community/index.rst

@@ -0,0 +1,11 @@
+Community
+=========
+
+.. toctree::
+   :maxdepth: 1
+   :name: toc-community
+
+   contributing/index
+   channels
+   tutorials
+   resources

community/resources.rst

@@ -0,0 +1,11 @@
+.. _doc_community_resources:
+
+Resources
+=========
+
+This is a list of third-party resources created by the community that may be of interest.
+
+General
+---------------
+
+- `awesome-godot: A curated list of resources by Calinou <https://github.com/Calinou/awesome-godot>`_

community/tutorials.rst

@@ -0,0 +1,12 @@
+.. _doc_community_tutorials:
+
+Tutorials
+=========
+
+This is a list of third-party tutorials created by the community that may be of interest.
+
+Video tutorials
+---------------
+
+- `GDQuest <https://www.youtube.com/channel/UCxboW7x0jZqFdvMdCFKTMsQ/playlists>`_
+- `KidsCanCode <https://www.youtube.com/channel/UCNaPQ5uLX5iIEHUCLmfAgKg/playlists>`_

community/tutorials/3d/index.rst

@@ -1,10 +0,0 @@
-3D
-==
-
-.. toctree::
-   :maxdepth: 1
-   :name: toc-community-tutorials-3d
-
-   mesh_generation_with_heightmap_and_shaders
-   working_with_3d_skeletons
-   inverse_kinematics

community/tutorials/index.rst

@@ -1,12 +0,0 @@
-Tutorials
-=========
-
-.. toctree::
-   :maxdepth: 1
-   :name: toc-community-tutorials
-
-   3d/index
-   gdnative/index
-   vr/index
-
-.. external_resources

index.rst

@@ -68,18 +68,18 @@ The main documentation for the site is organized into the following sections:
    tutorials/shading/index
    tutorials/networking/index
    tutorials/assetlib/index
-   tutorials/misc/index
+   tutorials/vr/index
+   tutorials/plugins/index
    tutorials/platform/index
+   tutorials/misc/index
 
 .. toctree::
    :maxdepth: 1
    :caption: Development
    :name: sec-devel
 
-   development/plugins/index
    development/compiling/index
    development/cpp/index
-   development/consoles/consoles
 
 
 .. toctree::
@@ -87,8 +87,7 @@ The main documentation for the site is organized into the following sections:
    :caption: Community
    :name: sec-community
 
-   community/contributing/index
-   community/tutorials/index
+   community/index
 
 
 .. toctree::

tutorials/3d/index.rst

@@ -15,3 +15,6 @@
    environment_and_post_processing
    high_dynamic_range
    using_gridmaps
+   working_with_3d_skeletons
+   inverse_kinematics
+   mesh_generation_with_heightmap_and_shaders

tutorials/platform/index.rst

@@ -7,3 +7,4 @@ Platform-specific
 
    android_in_app_purchases
    services_for_ios
+   consoles

development/plugins/index.rst → tutorials/plugins/editor/index.rst

@@ -3,7 +3,7 @@ Editor plugins
 
 .. toctree::
    :maxdepth: 1
-   :name: toc-devel-plugins
+   :name: toc-tutorials-plugins
 
    making_plugins
    import_plugins

community/tutorials/gdnative/index.rst → tutorials/plugins/gdnative/index.rst

@@ -1,8 +1,8 @@
-GDNATIVE
+GDNative
 ========
 
 .. toctree::
    :maxdepth: 1
-   :name: toc-community-tutorials-gdnative
+   :name: toc-tutorials-gdnative
 
    gdnative-c-example

tutorials/plugins/index.rst

@@ -0,0 +1,9 @@
+Plugins
+=======
+
+.. toctree::
+   :maxdepth: 1
+   :name: toc-tutorials-extending
+
+   editor/index
+   gdnative/index

community/tutorials/vr/index.rst → tutorials/vr/index.rst

@@ -3,6 +3,6 @@ VR
 
 .. toctree::
    :maxdepth: 1
-   :name: toc-community-tutorials-vr
+   :name: toc-tutorials-vr
 
    vr_primer