Docs: link stable docs versions (#141)

* use stable docs
* prune sphinx

Author: Borda

.actions/assistant.py

@@ -38,7 +38,7 @@
 # Open in [![Open In Colab](https://colab.research.google.com/assets/colab-badge.png){{height="20px" width="117px"}}]({COLAB_REPO_LINK}/{REPO_NAME}/blob/{BRANCH_PUBLISHED}/{DIR_NOTEBOOKS}/%(local_ipynb)s)
 #
 # Give us a ⭐ [on Github](https://www.github.com/PytorchLightning/pytorch-lightning/)
-# | Check out [the documentation](https://pytorch-lightning.readthedocs.io/en/latest/)
+# | Check out [the documentation](https://pytorch-lightning.readthedocs.io/en/stable/)
 # | Join us [on Slack](https://join.slack.com/t/pytorch-lightning/shared_invite/zt-pw5v393p-qRaDgEk24~EjiZNBpSQFgQ)
 
 """

.github/CONTRIBUTING.md

@@ -58,7 +58,7 @@ ______________________________________________________________________
 
 ## Guidelines
 
-For this section, we refer to read the [parent PL guidelines](https://pytorch-lightning.readthedocs.io/en/latest/CONTRIBUTING.html)
+For this section, we refer to read the [parent PL guidelines](https://pytorch-lightning.readthedocs.io/en/stable/CONTRIBUTING.html)
 
 **Reminder**
 

.github/workflows/ci_docs.yml

@@ -79,7 +79,7 @@ jobs:
         working-directory: ./docs
         run: |
           # First run the same pipeline as Read-The-Docs
-          make html --debug --jobs $(nproc) SPHINXOPTS="-W --keep-going" -b linkcheck
+          make html --debug SPHINXOPTS="-W --keep-going" -b linkcheck
 
       - name: Upload built docs
         uses: actions/upload-artifact@v2

course_UvA-DL/09-normalizing-flows/NF_image_modeling.py

@@ -1,6 +1,6 @@
 # %% [markdown]
 # <div class="center-wrapper"><div class="video-wrapper"><iframe src="https://www.youtube.com/embed/U1fwesIusbg" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe></div></div>
-# Throughout this notebook, we make use of [PyTorch Lightning](https://pytorch-lightning.readthedocs.io/en/latest/).
+# Throughout this notebook, we make use of [PyTorch Lightning](https://pytorch-lightning.readthedocs.io/en/stable/).
 # The first cell imports our usual libraries.
 
 # %%

course_UvA-DL/10-autoregressive-image-modeling/Autoregressive_Image_Modeling.py

@@ -26,7 +26,7 @@
 #
 # First of all, we need to import our standard libraries. Similarly as in
 # the last couple of tutorials, we will use [PyTorch
-# Lightning](https://pytorch-lightning.readthedocs.io/en/latest/) here as
+# Lightning](https://pytorch-lightning.readthedocs.io/en/stable/) here as
 # well.
 
 # %%

docs/source/conf.py

@@ -219,8 +219,8 @@
 # -- Options for intersphinx extension ---------------------------------------
 
 # Example configuration for intersphinx: refer to the Python standard library.
-intersphinx_mapping = {
-    "python": ("https://docs.python.org/3", None),
-    "torch": ("https://pytorch.org/docs/stable/", None),
-    "numpy": ("https://docs.scipy.org/doc/numpy/", None),
-}
+# intersphinx_mapping = {
+#     "python": ("https://docs.python.org/3", None),
+#     "torch": ("https://pytorch.org/docs/stable/", None),
+#     "numpy": ("https://docs.scipy.org/doc/numpy/", None),
+# }

lightning_examples/datamodules/.meta.yml

@@ -8,7 +8,7 @@ description: This notebook will walk you through how to start using Datamodules.
   the release of `pytorch-lightning` version 0.9.0, we have included a new class called
   `LightningDataModule` to help you decouple data related hooks from your `LightningModule`.
   The most up to date documentation on datamodules can be found
-  [here](https://pytorch-lightning.readthedocs.io/en/latest/extensions/datamodules.html).
+  [here](https://pytorch-lightning.readthedocs.io/en/stable/extensions/datamodules.html).
 requirements:
   - torchvision
 accelerator:

lightning_examples/mnist-tpu-training/.meta.yml

@@ -8,7 +8,7 @@ tags:
   - Image
 description: In this notebook, we'll train a model on TPUs. Updating one Trainer flag is all you need for that.
   The most up to documentation related to TPU training can be found
-  [here](https://pytorch-lightning.readthedocs.io/en/latest/advanced/tpu.html).
+  [here](https://pytorch-lightning.readthedocs.io/en/stable/advanced/tpu.html).
 requirements:
   - torchvision
 accelerator:

lightning_examples/mnist-tpu-training/mnist-tpu.py

@@ -22,7 +22,7 @@
 # ### Defining The `MNISTDataModule`
 #
 # Below we define `MNISTDataModule`. You can learn more about datamodules
-# in [docs](https://pytorch-lightning.readthedocs.io/en/latest/extensions/datamodules.html).
+# in [docs](https://pytorch-lightning.readthedocs.io/en/stable/extensions/datamodules.html).
 
 
 # %%