Add a pre-commit check to prevent urls pointing to pymc docs (#311)

* initial try

* undo spacing error

* specify location files

* update paths

* add exclude notebooks

* missing notebooks

* undo spacing

Author: Juan Orduz

.pre-commit-config.yaml

@@ -55,6 +55,50 @@ repos:
       minimum_pre_commit_version: 2.8.0
       name: Check notebooks have watermark (see Jupyter style guide from PyMC docs)
       types: [jupyter]
+    - id: no-internal-links
+      name: Check no internal links are in the docs
+      description: >-
+        'A quick check to prevent urls pointing to pymc docs'
+      files: ^examples/
+      exclude: >
+          (?x)(index.md|
+               404.md|
+               conf.py|
+               examples/case_studies/LKJ.ipynb|
+               examples/case_studies/LKJ.ipynb|
+               examples/case_studies/blackbox_external_likelihood.ipynb|
+               examples/case_studies/blackbox_external_likelihood_numpy.ipynb|
+               examples/case_studies/item_response_nba.ipynb|
+               examples/case_studies/multilevel_modeling.ipynb|
+               examples/diagnostics_and_criticism/sampler-stats.ipynb|
+               examples/gaussian_processes/GP-MaunaLoa2.ipynb|
+               examples/generalized_linear_models/GLM-logistic.ipynb|
+               examples/generalized_linear_models/GLM-out-of-sample-predictions.ipynb|
+               examples/generalized_linear_models/GLM-poisson-regression.ipynb|
+               examples/generalized_linear_models/GLM-robust.ipynb|
+               examples/generalized_linear_models/GLM-rolling-regression.ipynb|
+               examples/generalized_linear_models/GLM-simpsons-paradox.ipynb|
+               examples/pymc3_howto/api_quickstart.ipynb|
+               examples/samplers/MLDA_gravity_surveying.ipynb|
+               examples/samplers/MLDA_simple_linear_regression.ipynb|
+               examples/samplers/SMC-ABC_Lotka-Volterra_example.ipynb|
+               examples/splines/spline.ipynb|
+               examples/survival_analysis/censored_data.ipynb|
+               examples/survival_analysis/weibull_aft.ipynb)
+      entry: >
+          (?x)(arviz-devs.github.io|
+               aesara.readthedocs.io|
+               aeppl.readthedocs.io|
+               pymc-experimental.readthedocs.io|
+               docs.pymc.io|
+               numpy.org/doc|
+               pymc-examples.readthedocs.io|
+               docs.python.org|
+               xarray.pydata.org
+               python.arviz.org|
+               docs.xarray.dev)
+      language: pygrep
+      types_or: [markdown, rst, jupyter]
 - repo: https://github.com/mwouts/jupytext
   rev: v1.13.7
   hooks: