Remove notebooks, replace with pymc-examples submodule

.gitmodules

@@ -0,0 +1,3 @@
+[submodule "docs/source/pymc-examples"]
+	path = docs/source/pymc-examples
+	url = git@github.com:pymc-devs/pymc-examples.git

.pre-commit-config.yaml

@@ -13,16 +13,6 @@ repos:
     -   id: requirements-txt-fixer
         exclude: ^requirements-dev\.txt$
     -   id: trailing-whitespace
-- repo: https://github.com/nbQA-dev/nbQA
-  rev: 0.5.5
-  hooks:
-    - id: nbqa-black
-      additional_dependencies: [black==20.8b1]
-    - id: nbqa-isort
-      additional_dependencies: [isort==5.6.4]
-    - id: nbqa-pyupgrade
-      additional_dependencies: [pyupgrade==2.7.4]
-      args: [--py37-plus]
 - repo: https://github.com/PyCQA/isort
   rev: 5.6.4
   hooks:
@@ -45,18 +35,6 @@ repos:
       files: ^pymc3/
 - repo: local
   hooks:
-    - id: watermark
-      args: [--negate, --multiline]
-      entry: '%load_ext watermark.*%watermark -n -u -v -iv -w'
-      language: pygrep
-      minimum_pre_commit_version: 2.8.0
-      name: Check notebooks have watermark (see Jupyter style guide from PyMC3 Wiki)
-      types: [jupyter]
-    - id: check-toc
-      entry: python scripts/check_toc_is_complete.py
-      language: python
-      name: Check all notebooks appear in table of contents
-      types: [jupyter]
     - id: check-no-tests-are-ignored
       entry: python scripts/check_all_tests_are_covered.py
       files: ^\.github/workflows/pytest\.yml$

build_and_deploy_docs.sh

@@ -3,6 +3,7 @@
 latesttag=$(git describe --tags `git rev-list --tags --max-count=1`)
 echo checking out ${latesttag}
 git checkout ${latesttag}
+git submodule update --init --recursive
 pushd docs/source
 make html
 ghp-import -c docs.pymc.io -n -p _build/html/

docs/source/index.rst

@@ -96,7 +96,7 @@
                     </div>
                 </a>
 
-                <a class="ui link card" href="/notebooks/variational_api_quickstart.html">
+                <a class="ui link card" href="/pymc-examples/notebooks/variational_api_quickstart.html">
                     <div class="content">
                         <div class="header">Variational Inference</div>
                         <div class="description">Variational inference saves computational cost by turning a problem of integration into one of optimization. PyMC3's variational API supports a number of cutting edge algorithms, as well as minibatch for scaling to large datasets.