hierarchy re-org

Author: cspotcode

doc/about/introduction.rst

@@ -0,0 +1,11 @@
+What is Arcade?
+===============
+
+Arcade is an easy-to-learn Python library for creating 2D video games. It is ideal for people learning to program, or developers that want to code a 2D game without learning a complex framework.
+
+.. raw:: html
+
+    <div style="padding:55% 0 0 0;position:relative;">
+      <iframe class="vimeo-video" src="https://player.vimeo.com/video/662273899?h=31bf92c415&amp;badge=0&amp;autopause=0&amp;player_id=0&amp;app_id=58479" allow="autoplay; fullscreen; picture-in-picture" allowfullscreen title="Arcade Demo.mp4"></iframe>
+    </div><script src="https://player.vimeo.com/api/player.js"></script>
+    <p><a href="https://vimeo.com/662273899">Quick Arcade Library Introduction Video</a></p>

doc/api_docs/arcade.rst

@@ -35,7 +35,6 @@ for the Python Arcade library. See also:
     api/window
     api/sound
     api/path_finding
-    api/version
     api/isometric
     api/earclip
     api/easing
@@ -47,7 +46,7 @@ for the Python Arcade library. See also:
 
 .. toctree::
     :maxdepth: 1
-    :caption: Arcade GUI
+    :caption: GUI
 
     api/gui
     api/gui_widgets
@@ -57,16 +56,8 @@ for the Python Arcade library. See also:
 
 .. toctree::
     :maxdepth: 1
-    :caption: Arcade Sub Modules
+    :caption: Constants
 
     arcade.key
     arcade.csscolor
     arcade.color
-
-.. toctree::
-    :maxdepth: 1
-    :caption: Other Information
-
-    resources
-    keyboard
-

doc/contributing_guide/how_to_contribute.rst

@@ -1,6 +1,6 @@
 .. _how-to-contribute:
 
-How to Contribute
+Ways to Contribute
 =================
 
 We would love to have you contribute to the project! There are several

doc/contributing_guide/index.rst

@@ -2,20 +2,3 @@
 .. _cg_index_quickstart:
 
 .. include:: ../../CONTRIBUTING.rst
-
-.. _cg_index_contents:
-
-Contributing Guide Contents
----------------------------
-
-The sections linked below provide more in-depth coverage of various topics
-contributing to arcade, including links to outside resources on development tools
-and practices.
-
-.. toctree::
-    :maxdepth: 1
-
-    directory_structure
-    how_to_contribute
-    how_to_submit_changes
-    release_checklist

doc/index.rst

@@ -9,6 +9,10 @@
 The Python Arcade Library
 =========================
 
+Arcade is an easy-to-learn Python library for creating 2D video games. It is
+ideal for people learning to program, or developers that want to code a 2D
+game without learning a complex framework.
+
 .. |Go| image:: images/woman_sprinter.svg
    :width: 48
    :alt: Start Here
@@ -33,13 +37,26 @@ The Python Arcade Library
       </tr>
    </table>
 
+.. image:: images/example_games.svg
+   :alt: Get Started icon
+   :class: heading-icon
+
+.. toctree::
+   :maxdepth: 1
+   :caption: Get Started
+
+   about/introduction
+   programming_guide/get_started
+   programming_guide/install/index
+   programming_guide/how_to_get_help
+
 .. image:: images/example_code.svg
    :alt: Example Code
    :class: heading-icon
 
 .. toctree::
    :maxdepth: 1
-   :caption: Example Code
+   :caption: Examples
 
    example_code/how_to_examples/index
    example_code/game_jam_2020
@@ -60,7 +77,6 @@ The Python Arcade Library
    tutorials/lights/index
    tutorials/bundling_with_pyinstaller/index
    tutorials/compiling_with_nuitka/index
-   tutorials/framebuffer/index
    tutorials/shader_tutorials
    tutorials/menu/index
 
@@ -70,34 +86,33 @@ The Python Arcade Library
 
 .. toctree::
    :maxdepth: 1
-   :caption: Programming Guide
+   :caption: Guide
 
-   programming_guide/get_started
-   programming_guide/install/index
    programming_guide/sprites/index
-   programming_guide/how_to_get_help
+   programming_guide/keyboard
+   programming_guide/textures
+   programming_guide/sections
+   programming_guide/gui/index
+   programming_guide/texture_atlas
    programming_guide/edge_artifacts/index
    programming_guide/logging
-   programming_guide/pygame_comparison
+   programming_guide/opengl_notes
+   tutorials/framebuffer/index
+   programming_guide/performance_tips
    programming_guide/headless
    programming_guide/vsync
-   programming_guide/textures
-   programming_guide/texture_atlas
-   programming_guide/opengl_notes.rst
-   programming_guide/gui/index
-   programming_guide/performance_tips
-   programming_guide/sections
+   programming_guide/pygame_comparison
 
 .. image:: images/API.svg
    :alt: API icon
    :class: heading-icon
 
 .. toctree::
    :maxdepth: 1
-   :caption: API Docs
+   :caption: API
 
    api_docs/api/quick_index
-   api_docs/arcade
+   Reference<api_docs/arcade>
    api_docs/resources
 
 .. image:: images/source.svg
@@ -106,12 +121,25 @@ The Python Arcade Library
 
 .. toctree::
    :maxdepth: 1
-   :caption: Source Code & Contributing
+   :caption: Source Code
 
    GitHub <https://github.com/pythonarcade/arcade>
    programming_guide/release_notes
    License <https://github.com/pythonarcade/arcade/blob/development/license.rst>
+
+.. image:: images/source.svg
+   :alt: Source icon
+   :class: heading-icon
+
+.. toctree::
+   :maxdepth: 1
+   :caption: Contributing
+
+   contributing_guide/how_to_contribute
    contributing_guide/index
+   contributing_guide/directory_structure
+   contributing_guide/how_to_submit_changes
+   contributing_guide/release_checklist
 
 .. image:: images/social.svg
    :alt: Social icon
@@ -145,15 +173,3 @@ Learning Resources
     * `Aus PyCon 2018 Multiplayer Games <https://youtu.be/2SMkk63k6Ik>`_
     * `US PyCon 2018 Talk <https://youtu.be/DAWHMHMPVHU>`_
 
-
-.. raw:: html
-
-    <div style="padding:55% 0 0 0;position:relative;">
-      <iframe class="vimeo-video" src="https://player.vimeo.com/video/662273899?h=31bf92c415&amp;badge=0&amp;autopause=0&amp;player_id=0&amp;app_id=58479" allow="autoplay; fullscreen; picture-in-picture" allowfullscreen title="Arcade Demo.mp4"></iframe>
-    </div><script src="https://player.vimeo.com/api/player.js"></script>
-    <p><a href="https://vimeo.com/662273899">Quick Arcade Library Introduction Video</a></p>
-
-Arcade is an easy-to-learn Python library for creating 2D video games. It is
-ideal for people learning to program, or developers that want to code a 2D
-game without learning a complex framework.
-

doc/programming_guide/install/index.rst

@@ -12,10 +12,10 @@ Select the instructions for your platform:
 .. toctree::
    :maxdepth: 1
 
-   pycharm
    windows
    mac
    linux
    source
+   pycharm
    obsolete