reorganize docs

Author: rmorshea

docs/source/_exts/autogen_api_docs.py

@@ -9,16 +9,16 @@
 HERE = Path(__file__).parent
 PACKAGE_SRC = HERE.parent.parent.parent / "src"
 
-AUTO_DIR = HERE.parent / "auto"
-AUTO_DIR.mkdir(exist_ok=True)
+REFERENCES_DIR = HERE.parent / "references"
+REFERENCES_DIR.mkdir(exist_ok=True)
 
-PUBLIC_API_REFERENCE_FILE = AUTO_DIR / "api-reference.rst"
-PRIVATE_API_REFERENCE_FILE = AUTO_DIR / "developer-apis.rst"
+PUBLIC_API_REFERENCE_FILE = REFERENCES_DIR / "user-apis.rst"
+PRIVATE_API_REFERENCE_FILE = REFERENCES_DIR / "developer-apis.rst"
 
 
-PUBLIC_TITLE = "API Reference\n=============\n"
+PUBLIC_TITLE = "User API\n=============\n"
 PUBLIC_MISC_TITLE = "Misc Modules\n------------\n"
-PRIVATE_TITLE = "Developer APIs\n==============\n"
+PRIVATE_TITLE = "Developer API\n==============\n"
 PRIVATE_MISC_TITLE = "Misc Dev Modules\n----------------\n"
 
 AUTODOC_TEMPLATE = ".. automodule:: {module}\n    :members:\n"

docs/source/changelog.rst renamed to docs/source/development/changelog.rst

@@ -0,0 +1,6 @@
+Basic Dashboard
+---------------
+
+Try interacting with the sliders 📈
+
+.. example:: simple_dashboard

docs/source/contributing.rst renamed to docs/source/development/contributing.rst

@@ -0,0 +1,8 @@
+Making a Game
+=============
+
+Click to start playing and use the arrow keys to move 🎮
+
+Slow internet may cause inconsistent frame pacing 😅
+
+.. example:: snake_game

docs/source/developer-guide.rst renamed to docs/source/development/developer-guide.rst

@@ -0,0 +1,6 @@
+Matplotlib Plot
+===============
+
+Pick the polynomial coefficients (separate each coefficient by a space) 🔢:
+
+.. example:: matplotlib_plot

docs/source/roadmap.rst renamed to docs/source/development/roadmap.rst

@@ -1,6 +1,9 @@
-Getting Started
+Simple Examples
 ===============
 
+Simple Slideshow
+----------------
+
 Let's break down the following example:
 
 .. example:: slideshow
@@ -93,3 +96,16 @@ WebSocket. To display the layout we can navigate to http://localhost:8765/client
 .. _VDOM mimetype specification: https://github.com/nteract/vdom/blob/master/docs/mimetype-spec.md
 .. _ReactJS: https://reactjs.org/docs/faq-internals.html
 .. _React Hooks: https://reactjs.org/docs/hooks-overview.html
+
+
+Click Counter
+-------------
+
+.. example:: click_count
+
+To Do List
+==========
+
+Try typing in the text box and pressing 'Enter' 📋
+
+.. example:: todo