speedup sphinx build/linting with caching doctrees and pip cache

Author: smoench

.github/workflows/ci.yaml

@@ -29,12 +29,29 @@ jobs:
             -   name: "Install Sphinx dependencies"
                 run: sudo apt-get install python-dev build-essential
 
-            -   name: "Install Sphinx"
-                run: pip install --user sphinx
+            -   name: "Cache pip"
+                uses: actions/cache@v1
+                with:
+                    path: ~/.cache/pip
+                    key: ${{ runner.os }}-pip-${{ hashFiles('_build/.requirements.txt') }}
+                    restore-keys: |
+                        ${{ runner.os }}-pip-
 
-            -   name: "Install custom requirements via pip"
+            -   name: "Install spinx + requirements via pip"
                 run: pip install -r _build/.requirements.txt
 
+            -   name: "Cache sphinx doctrees"
+                uses: actions/cache@v1
+                with:
+                    path: ./_build/doctrees
+                    key: ${{ runner.os }}-sphinx-doctrees
+
+            -   name: "Cache sphinx html"
+                uses: actions/cache@v1
+                with:
+                    path: ./_build/html
+                    key: ${{ runner.os }}-sphinx-html
+
             -   name: "Build documentation"
                 run: make -C _build SPHINXOPTS=-nW html