From 523a36c03de661ece80e5ad10aef1b3cdcb5fda9 Mon Sep 17 00:00:00 2001
From: Andrew Jones <andyjones.ed@gmail.com>
Date: Sun, 5 Jul 2020 19:45:01 +0000
Subject: [PATCH] Adds tutorial stubs

---
 docs/api.rst                        |  7 +++++++
 docs/conf.py                        | 25 ++++++++++++++++++-------
 docs/index.rst                      | 24 ++++++++++++++++++++----
 docs/tutorials/env-competitive.rst  |  3 +++
 docs/tutorials/env-minimal.rst      |  3 +++
 docs/tutorials/env-single-agent.rst |  3 +++
 docs/tutorials/train.rst            |  2 ++
 onedee/core.py                      |  1 +
 8 files changed, 57 insertions(+), 11 deletions(-)
 create mode 100644 docs/api.rst
 create mode 100644 docs/tutorials/env-competitive.rst
 create mode 100644 docs/tutorials/env-minimal.rst
 create mode 100644 docs/tutorials/env-single-agent.rst
 create mode 100644 docs/tutorials/train.rst

diff --git a/docs/api.rst b/docs/api.rst
new file mode 100644
index 0000000..8c11c0c
--- /dev/null
+++ b/docs/api.rst
@@ -0,0 +1,7 @@
+#################
+API Documentation
+#################
+
+.. automodule:: onedee.core
+    :members:
+    :undoc-members:
diff --git a/docs/conf.py b/docs/conf.py
index 5ff80b1..a15380e 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -10,10 +10,10 @@
 # add these directories to sys.path here. If the directory is relative to the
 # documentation root, use os.path.abspath to make it absolute, like shown here.
 #
-# import os
-# import sys
-# sys.path.insert(0, os.path.abspath('.'))
-# print(sys.path)
+import os
+import sys
+sys.path.insert(0, os.path.abspath('..'))
+print(sys.path)
 
 
 # -- Project information -----------------------------------------------------
@@ -32,7 +32,7 @@
 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
 # ones.
 extensions = [
-    "sphinx_rtd_theme",
+    'sphinx.ext.autodoc'
 ]
 
 # Add any paths that contain templates here, relative to this directory.
@@ -49,8 +49,19 @@
 # The theme to use for HTML and HTML Help pages.  See the documentation for
 # a list of builtin themes.
 #
-html_theme = "sphinx_rtd_theme"
-
+html_theme = "alabaster"
+
+html_theme_options = {
+    'description': 'RL at 1m FPS'
+}
+
+html_sidebars = {
+    '**': [
+        'about.html',
+        'navigation.html',
+        'relations.html',
+    ]
+}
 
 # Add any paths that contain custom static files (such as style sheets) here,
 # relative to this directory. They are copied after the builtin static files,
diff --git a/docs/index.rst b/docs/index.rst
index 524f9a8..bd7660f 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -3,10 +3,26 @@
    You can adapt this file completely to your liking, but it should at least
    contain the root `toctree` directive.
 
-Welcome to onedee's documentation!
-==================================
+######
+onedee
+######
 
+*********
+Tutorials
+*********
+.. toctree::
+   :maxdepth: 1
+
+   tutorials/env-minimal
+   tutorials/env-single-agent
+   tutorials/env-competitive
+   tutorials/train
+
+********
+API Docs
+********
 .. toctree::
    :maxdepth: 2
-   :caption: Contents:
-      test
\ No newline at end of file
+
+   api
+
diff --git a/docs/tutorials/env-competitive.rst b/docs/tutorials/env-competitive.rst
new file mode 100644
index 0000000..56b56a1
--- /dev/null
+++ b/docs/tutorials/env-competitive.rst
@@ -0,0 +1,3 @@
+##################################
+Building a Competitive Environment
+##################################
\ No newline at end of file
diff --git a/docs/tutorials/env-minimal.rst b/docs/tutorials/env-minimal.rst
new file mode 100644
index 0000000..defa4cd
--- /dev/null
+++ b/docs/tutorials/env-minimal.rst
@@ -0,0 +1,3 @@
+##############################
+Building a Minimal Environment
+##############################
\ No newline at end of file
diff --git a/docs/tutorials/env-single-agent.rst b/docs/tutorials/env-single-agent.rst
new file mode 100644
index 0000000..4afaaa3
--- /dev/null
+++ b/docs/tutorials/env-single-agent.rst
@@ -0,0 +1,3 @@
+###################################
+Building a Single-Agent Environment
+###################################
\ No newline at end of file
diff --git a/docs/tutorials/train.rst b/docs/tutorials/train.rst
new file mode 100644
index 0000000..f2b3a04
--- /dev/null
+++ b/docs/tutorials/train.rst
@@ -0,0 +1,2 @@
+Training An Agent
+#################
\ No newline at end of file
diff --git a/onedee/core.py b/onedee/core.py
index 7fd96ac..f5618d1 100644
--- a/onedee/core.py
+++ b/onedee/core.py
@@ -25,6 +25,7 @@ def select(x, d):
     return x.vals[s:e]
 
 class Core: 
+    """The core rendering and physics interface"""
 
     def __init__(self, geometries, n_agents=1, res=64, supersample=8, fov=130, fps=10):
         self.geometries = geometries