Docs: improve.

Author: bjones1

index.rst

@@ -24,6 +24,8 @@ Components
     runestone/*/toctree
     runestone/__init__.py
     runestone/__main__.py
+    runestone/conftest.py
+    runestone/shared_conftest.py
     runestone/unittest_base.py
 
 
@@ -35,6 +37,7 @@ Packaging
     setup.py
     setup.cfg
     MANIFEST.in
+    webpack.config.js
 
 Misc
 ====
@@ -44,11 +47,11 @@ Misc
     ACKNOWLEDGEMENTS
     .github/FUNDING.yml
     .gitignore
+    .github/workflows/python-package.yml
     .readthedocs.yml
     conf.py
     codechat_config.yaml
     requirements-dev.in
     requirements.in
-    webpack.config.js
     public/index.html
     makeRelease.sh

runestone/activecode/toctree.rst

@@ -1,6 +1,8 @@
 *************************************************
-ActiveCode
+ActiveCode - Run code in the browser
 *************************************************
+See the `overview <https://runestone.academy/runestone/books/published/overview/ActiveCode/toctree.html>`_.
+
 .. toctree::
     :maxdepth: 1
     :glob:

runestone/assignment/__init__.py

@@ -1,3 +1,7 @@
+# ***********************************************
+# |docname| - Define the ``assignment`` directive
+# ***********************************************
+#
 # Copyright (C) 2015  Paul Resnick
 #
 # This program is free software: you can redistribute it and/or modify

runestone/assignment/toctree.rst

@@ -1,11 +1,7 @@
-*************************************************
-Accessibility
-*************************************************
+**************************************************
+Assignment - directives for creating an assignment
+**************************************************
 .. toctree::
     :maxdepth: 1
-    :glob:
 
-    *.py
-    js/*.js
-    css/*.css
-    test/test_*.py
+    __init__.py

runestone/blockly/toctree.rst

@@ -1,11 +1,11 @@
-*************************************************
-Accessibility
-*************************************************
+********************************************************
+Blockly - Embed block-based code generation in Runestone
+********************************************************
+Warning: This component is deprecated. Do not use it in new books.
+
 .. toctree::
     :maxdepth: 1
     :glob:
 
+    README
     *.py
-    js/*.js
-    css/*.css
-    test/test_*.py

runestone/fitb/fitb.py

@@ -1,6 +1,6 @@
-# *********
-# |docname|
-# *********
+# ******************************************************************
+# |docname| - Provide Sphinx support for fill-in-the-blank questions
+# ******************************************************************
 #
 # .. Copyright (C) 2013  Bradley N. Miller
 #

runestone/selectquestion/toctree.rst

@@ -0,0 +1,12 @@
+*************************************************
+Dynamic Questions
+*************************************************
+See the `overview book <https://runestone.academy/runestone/books/published/overview/Containers/dynamic.html>`_ for user documentation.
+
+.. toctree::
+    :maxdepth: 1
+    :glob:
+
+    *.py
+    js/*.js
+    css/*.css

runestone/timed/toctree.rst

@@ -1,6 +1,8 @@
 *************************************************
-Accessibility
+Timed Exam Questions
 *************************************************
+See the `overview book <https://runestone.academy/runestone/books/published/overview/Assessments/timed.html>`_ for user documentation.
+
 .. toctree::
     :maxdepth: 1
     :glob: