Add remaining docstrings and flesh out API reference (#92)

Author: cpsievert

docs/README.md

@@ -0,0 +1,30 @@
+# PyShiny API reference
+
+## Build locally
+
+To build the PyShiny API reference locally, do:
+
+```sh
+make clean && make html
+```
+
+Note that `make clean` won't remove `source/reference` files, so you may periodically want to `rm -r source/reference` to truly have a clean build.
+
+## Preview locally
+
+Serve the contents of `build/html`
+
+```sh
+cd build/html
+python3 -m http.server
+```
+
+(Then open your browser to <http://localhost:8000>)
+
+## Development
+
+It's recommended to use VSCode's [reStructuredText extension](https://marketplace.visualstudio.com/items?itemName=lextudio.restructuredtext) (as well as it's recommended extensions) when contributing to these docs. **Just make sure you open VSCode from the docs folder**:
+
+```sh
+code prism/docs
+```

docs/source/_templates/class.rst

@@ -0,0 +1,37 @@
+..
+    Derived from the sphinx v3.0.4 source code: sphinx/ext/autosummary/templates/autosummary/class.rst
+    This slightly modified version is used to get methods to hyperlink to their own
+    reference/ page (i.e., it adds toctree to autosummary) and hides the __init__ method
+
+{{ fullname | escape | underline}}
+
+.. currentmodule:: {{ module }}
+
+.. autoclass:: {{ objname }}
+
+    {% block methods %}
+
+    {% if methods %}
+    .. rubric:: Methods
+
+    .. autosummary::
+        :toctree:
+    {% for item in methods %}
+    {%- if item not in ['__init__', 'call_pyodide'] %}
+        ~{{ name }}.{{ item }}
+    {% endif %}
+    {%- endfor %}
+    {% endif %}
+    {% endblock %}
+
+    {% block attributes %}
+    {% if attributes %}
+    .. rubric:: Attributes
+
+    .. autosummary::
+      :toctree:
+    {% for item in attributes %}
+        ~{{ name }}.{{ item }}
+    {%- endfor %}
+    {% endif %}
+    {% endblock %}

docs/source/_templates/justattributes.rst

@@ -0,0 +1,20 @@
+
+{{ fullname | escape | underline}}
+
+.. currentmodule:: {{ module }}
+
+.. autoclass:: {{ objname }}
+
+    {% block methods %}
+    {% endblock %}
+
+    {% block attributes %}
+    {% if attributes %}
+    .. rubric:: Attributes
+
+    .. autosummary::
+    {% for item in attributes %}
+        ~{{ name }}.{{ item }}
+    {%- endfor %}
+    {% endif %}
+    {% endblock %}

docs/source/_templates/tag_func.rst

@@ -0,0 +1,8 @@
+..
+  This essentially replaces the default behavior of .. autosummary::, which is
+  https://raw.githubusercontent.com/sphinx-doc/sphinx/4.x/sphinx/ext/autosummary/templates/autosummary/base.rst
+  For whatever reason, that default behavior doesn't work when applied to ui.tags
+
+{{ fullname | escape | underline}}
+
+.. auto{{ objtype }}:: {{ module }}.{{ objname }}

docs/source/_templates/tags.rst

@@ -0,0 +1,13 @@
+{{ fullname | escape | underline}}
+
+.. automodule:: {{fullname}}
+
+.. autosummary::
+    :toctree:
+    :template: tag_func.rst
+
+    {% block functions %}
+    {% for item in functions %}
+    ~{{ fullname }}.{{ item }}
+    {%- endfor %}
+    {% endblock %}