Remove notebooks, replace with pymc-examples submodule (#4348)

* 🔥 remove notebooks from pymc3, replace with pymc-examples submodule

* change notebook output_html

* revert href change

* 📝 release notes

* 🚚 move examples to pymc-examples

* checkout submodule at main

* noop

* 🔥 remove test_examples

* keep examples/data for now, so pm.get_data keeps working

* keep examples/__init__.py so get_data still works

* revert removing examples

* revert removing test_examples

* fixup so docs work with latest pymc-examples reorg

* 🎨

Author: MarcoGorelli

.gitmodules

@@ -0,0 +1,3 @@
+[submodule "docs/source/pymc-examples"]
+	path = docs/source/pymc-examples
+	url = [email protected]: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$

RELEASE-NOTES.md

@@ -12,6 +12,7 @@ This is the first release to support Python3.9 and to drop Python3.6.
 - Make `sample_shape` same across all contexts in `draw_values` (see [#4305](https://github.com/pymc-devs/pymc3/pull/4305)).
 - Removed `theanof.set_theano_config` because it illegally touched Theano's privates (see [#4329](https://github.com/pymc-devs/pymc3/pull/4329)).
 - In `sample_posterior_predictive` the `vars` kwarg was removed in favor of `var_names` (see [#4343](https://github.com/pymc-devs/pymc3/pull/4343)).
+- The notebook gallery has been moved to https://github.com/pymc-devs/pymc-examples (see [#4348](https://github.com/pymc-devs/pymc3/pull/4348)).
 
 
 ## PyMC3 3.10.0 (7 December 2020)

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/examples/variational_inference/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.