ARROW-85 Add linkcheck to CI (#79)

Author: blink1073

.github/workflows/test-python.yml

@@ -79,3 +79,38 @@ jobs:
         run: |
           pip install check-manifest
           check-manifest -v
+
+  docs:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - name: Cache conda
+        uses: actions/cache@v2
+        env:
+          # Increase this value to reset cache if environment.yml has not changed
+          CACHE_NUMBER: 0
+        with:
+          path: ~/conda_pkgs_dir
+          key:
+            ${{ runner.os }}-conda-${{ env.CACHE_NUMBER }}-${{
+            hashFiles('bindings/python/docs/environment.yml') }}
+      - uses: conda-incubator/setup-miniconda@v2
+        with:
+          auto-update-conda: true
+          activate-environment: mongo_arrow_documentation
+          environment-file: bindings/python/docs/environment.yml
+          use-only-tar-bz2: true  # IMPORTANT: This needs to be set for caching to work properly!
+      - name: Install lib
+        shell: bash -l {0}
+        run: |
+          pip install .
+      - name: Build docs with warnings
+        shell: bash -l {0}
+        run: |
+          pushd docs
+          make html SPHINXOPTS="-W"
+      - name: Run linkcheck
+        shell: bash -l {0}
+        run: |
+          pushd docs
+          make linkcheck

bindings/python/docs/source/index.rst

@@ -30,7 +30,7 @@ know to use **PyMongoArrow**.
 Getting Help
 ------------
 If you're having trouble or have questions about PyMongoArrow, ask your question on
-our `MongoDB Community Forum <https://developer.mongodb.com/community/forums/tags/c/drivers-odms-connectors/7/python-driver>`_.
+our `MongoDB Community Forum <https://www.mongodb.com/community/forums/tag/python>`_.
 Once you get an answer, it'd be great if you could work it back into this
 documentation and contribute!
 

bindings/python/docs/source/installation.rst

@@ -30,8 +30,10 @@ To upgrade using pip::
 
   $ python -m pip install --upgrade pymongoarrow
 
-.. attention:: If the install fails due to an error like ``ValueError: Could not find "libbson-1.0" library`` it means that ``pip`` failed to find a
-suitable wheel for your platform.  We recommend first ensuring you have ``pip`` >= 20.3 installed. To upgrade ``pip`` run::
+.. attention:: If the install fails due to an error like ``ValueError: Could
+  not find "libbson-1.0" library`` it means that ``pip`` failed to find a
+  suitable wheel for your platform.  We recommend first ensuring you have
+  ``pip`` >= 20.3 installed. To upgrade ``pip`` run::
 
      $ python -m pip install --upgrade pip