More docs and restructure

Author: einarf

docs/user_guide/controls.rst renamed to docs/controls.rst

@@ -7,7 +7,7 @@ Basic Keyboard Controls
 
 - ``ESC`` to exit
 - ``SPACE`` to pause the current time (tells the configured timer to pause)
-- ``X`` for taking a screenshot (output path is configurable in settings)
+- ``X`` for taking a screenshot (output path is configurable in :doc:`settings`)
 
 Camera Controls
 ^^^^^^^^^^^^^^^
@@ -23,7 +23,7 @@ Simply apply the ``view_matrix`` of the camera to your transformations.
 - ``D`` strafe right
 - ``Q`` down the y axis
 - ``E`` up the y axis
-- ``R`` reload all shaders
+- ``R`` reload shader programs (Needs configuration)
 
 **Mouse Controls**
 

docs/index.rst

@@ -8,31 +8,35 @@ A Python 3 cross platform OpenGL 3.3+ core framework based on `ModernGL <https:/
 | |screenshot1|   | |screenshot2|   |
 +-----------------+-----------------+
 
+.. warning:: The documentation for 2.0 is currently work in progress and you may find some sections outdated
 
-User Guide
-----------
+.. toctree::
+   :maxdepth: 2
+   :caption: Getting Started
 
-This is the user guide
+   quickstart
 
 .. toctree::
    :maxdepth: 2
+   :caption: User Guide
 
-   user_guide/quickstart
-   user_guide/controls
    user_guide/index
-
-Reference
----------
+   controls
 
 .. toctree::
-   :maxdepth: 1
+   :maxdepth: 2
+   :caption: Reference
 
-   reference/effect
-   reference/settings   
+   reference/index
+
+.. toctree::
+   :maxdepth: 2
+   :caption: Settings
 
+   settings
 
 Indices and tables
-==================
+------------------
 
 * :ref:`genindex`
 * :ref:`modindex`

docs/user_guide/quickstart.rst renamed to docs/quickstart.rst

@@ -86,7 +86,7 @@ We should now have the following structure:
     cube
     ├── effects.py
     ├── dependencies.py
-    └── resoruces
+    └── resources
         └── programs
             └── cube
                 └── default.glsl

docs/reference/index.rst

@@ -0,0 +1,10 @@
+
+Reference
+=========
+
+.. toctree::
+   :maxdepth: 2
+
+   effect
+   vao
+   geometry