pymc-devs · Sayam753 · Sep 5, 2021 · Oct 12, 2021 · Oct 14, 2021 · Oct 16, 2021
diff --git a/.gitignore b/.gitignore
@@ -17,6 +17,8 @@ tags
 
 # Sphinx
 _build
+docs/jupyter_execute
+docs/source/api
 
 # Merge tool
 *.orig

diff --git a/.gitmodules b/.gitmodules
diff --git a/conda-envs/environment-dev-py37.yml b/conda-envs/environment-dev-py37.yml
@@ -22,9 +22,8 @@ dependencies:
 - pytest>=3.0
 - python-graphviz
 - python=3.7
-- recommonmark>=0.4
 - scipy>1.4.1
-- sphinx-autobuild>=0.7
+- sphinx-copybutton
 - sphinx-notfound-page
 - sphinx-panels
 - sphinx>=1.5

diff --git a/conda-envs/environment-dev-py38.yml b/conda-envs/environment-dev-py38.yml
@@ -22,9 +22,8 @@ dependencies:
 - pytest>=3.0
 - python-graphviz
 - python=3.8
-- recommonmark>=0.4
 - scipy>1.4.1
-- sphinx-autobuild>=0.7
+- sphinx-copybutton
 - sphinx-notfound-page
 - sphinx-panels
 - sphinx>=1.5

diff --git a/conda-envs/environment-dev-py39.yml b/conda-envs/environment-dev-py39.yml
@@ -22,9 +22,8 @@ dependencies:
 - pytest>=3.0
 - python-graphviz
 - python=3.9
-- recommonmark>=0.4
 - scipy>1.4.1
-- sphinx-autobuild>=0.7
+- sphinx-copybutton
 - sphinx-notfound-page
 - sphinx-panels
 - sphinx>=1.5

diff --git a/conda-envs/windows-environment-dev-py38.yml b/conda-envs/windows-environment-dev-py38.yml
@@ -29,8 +29,8 @@ dependencies:
 - pydata-sphinx-theme
 - pytest-cov>=2.5
 - pytest>=3.0
-- recommonmark>=0.4
 - sphinx-autobuild>=0.7
+- sphinx-copybutton
 - sphinx-notfound-page
 - sphinx-panels
 - sphinx>=1.5

diff --git a/docs/logos/sponsors/numfocus.png b/docs/logos/sponsors/numfocus.png
diff --git a/docs/pymc-labs-logo.png → docs/logos/sponsors/pymc-labs.png b/docs/pymc-labs-logo.png → docs/logos/sponsors/pymc-labs.png
diff --git a/docs/pymc_logo.jpg b/docs/pymc_logo.jpg
diff --git a/docs/source/_templates/custom-class-template.rst b/docs/source/_templates/custom-class-template.rst
@@ -0,0 +1,5 @@
+{{ fullname | escape | underline}}
+
+.. currentmodule:: {{ module }}
+
+.. autoclass:: {{ objname }}
diff --git a/docs/source/_templates/custom-function-template.rst b/docs/source/_templates/custom-function-template.rst
@@ -0,0 +1,5 @@
+{{ fullname | escape | underline}}
+
+.. currentmodule:: {{ module }}
+
+.. autofunction:: {{ objname }}
diff --git a/docs/source/_templates/custom-module-template.rst b/docs/source/_templates/custom-module-template.rst
@@ -0,0 +1,69 @@
+{{ fullname | escape | underline}}
+
+.. automodule:: {{ fullname }}
+
+   {% block attributes %}
+   {% if attributes %}
+   .. rubric:: {{ _('Module Attributes') }}
+
+   .. autosummary::
+       :toctree:
+   {% for item in attributes %}
+      {{ item }}
+   {%- endfor %}
+   {% endif %}
+   {% endblock %}
+
+   {% block functions %}
+   {% if functions %}
+   .. rubric:: {{ _('Functions') }}
+
+   .. autosummary::
+       :toctree:
+       :template: custom-function-template.rst
+   {% for item in functions %}
+      {{ item }}
+   {%- endfor %}
+   {% endif %}
+   {% endblock %}
+
+   {% block classes %}
+   {% if classes %}
+   .. rubric:: {{ _('Classes') }}
+
+   .. autosummary::
+       :toctree:
+       :template: custom-class-template.rst
+   {% for item in classes %}
+      {{ item }}
+   {%- endfor %}
+   {% endif %}
+   {% endblock %}
+
+   {% block exceptions %}
+   {% if exceptions %}
+   .. rubric:: {{ _('Exceptions') }}
+
+   .. autosummary::
+       :toctree:
+   {% for item in exceptions %}
+      {{ item }}
+   {%- endfor %}
+   {% endif %}
+   {% endblock %}
+
+{% block modules %}
+{% if modules %}
+.. rubric:: Modules
+
+.. autosummary::
+   :toctree:
+   :template: custom-module-template.rst
+   :recursive:
+{% for item in modules %}
+   {% if "tests" not in item %}
+   {{ item }}
+   {% endif %}
+{%- endfor %}
+{% endif %}
+{% endblock %}
diff --git a/docs/source/_templates/footer.html b/docs/source/_templates/footer.html
@@ -0,0 +1,9 @@
+<footer class="footer mt-5 mt-md-0">
+  <div class="container">
+    {% for footer_item in theme_footer_items %}
+    <div class="footer-item">
+      {% include footer_item %}
+    </div>
+    {% endfor %}
+  </div>
+</footer>
diff --git a/docs/source/_templates/layout.html b/docs/source/_templates/layout.html
@@ -2,25 +2,25 @@
 
 <!-- Hide left sidebar in home page -->
 {% block docs_sidebar %}
-  {% if pagename != 'index' %}
-    {{ super() }}
-  {% endif %}
+{% if pagename != 'index' %}
+{{ super() }}
+{% endif %}
 {% endblock %}
 
 <!-- Hide right sidebar in home page -->
 {% block docs_toc %}
-  {% if pagename != 'index' %}
-    {{ super() }}
-  {% endif %}
+{% if pagename != 'index' %}
+{{ super() }}
+{% endif %}
 {% endblock %}
 
 <!-- Make body have full width in home page -->
 {% block docs_main %}
-  {% if pagename == 'index' %}
-    <main class="col-12 py-md-5 pl-md-5 pr-md-4 bd-content" role="main">
-      {% block body %} {% endblock %}
-    </main>
-  {% else %}
-    {{ super() }}
-  {% endif %}
+{% if pagename == 'index' %}
+<main class="col-12 py-md-5 pl-md-5 pr-md-4 bd-content" role="main">
+  {% block body %} {% endblock %}
+</main>
+{% else %}
+{{ super() }}
+{% endif %}
 {% endblock %}
diff --git a/docs/source/about.rst b/docs/source/about.rst
@@ -1,8 +1,3 @@
-:orphan:
-
-..
-    _href from docs/source/index.rst
-
 .. _about:
 
 **********

diff --git a/docs/source/api.rst b/docs/source/api.rst
@@ -1,36 +1,10 @@
-:orphan:
-
-..
-    _"api" is referenced in html_theme_options docs/source/conf.py
-
-.. _api:
-
 *************
 API Reference
 *************
 
-.. toctree::
-   :maxdepth: 2
-
-   api/distributions
-   api/bounds
-   api/inference
-   api/glm
-   api/gp
-   api/plots
-   api/stats
-   api/backends
-   api/math
-   api/data
-   api/model
-   api/model_graph
-   api/variables
-   api/shape_utils
-   api/ode
-
-Indices and tables
-===================
+.. autosummary::
+   :toctree: api
+   :template: custom-module-template.rst
+   :recursive:
 
-* :ref:`genindex`
-* :ref:`modindex`
-* :ref:`search`
+   pymc
diff --git a/docs/source/api/backends.rst b/docs/source/api/backends.rst
diff --git a/docs/source/api/bounds.rst b/docs/source/api/bounds.rst
diff --git a/docs/source/api/data.rst b/docs/source/api/data.rst
diff --git a/docs/source/api/distributions.rst b/docs/source/api/distributions.rst
diff --git a/docs/source/api/distributions/continuous.rst b/docs/source/api/distributions/continuous.rst