PYTHON-3164 Outdated link from PyMongo docs to community forum (#895)

Author: blink1073

.github/workflows/test-python.yml

@@ -65,3 +65,21 @@ jobs:
         run: |
           mypy --install-types --non-interactive bson gridfs tools pymongo
           mypy --install-types --non-interactive --disable-error-code var-annotated --disable-error-code attr-defined --disable-error-code union-attr --disable-error-code assignment --disable-error-code no-redef --disable-error-code index --allow-redefinition --allow-untyped-globals --exclude "test/mypy_fails/*.*" test
+
+  linkcheck:
+    name: Check Links
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - uses: actions/setup-python@v2
+        with:
+          cache: 'pip'
+          cache-dependency-path: 'setup.py'
+      - name: Install dependencies
+        run: |
+          python -m pip install -U pip
+          python -m pip install sphinx
+      - name: Check links
+        run: |
+          cd doc
+          make linkcheck

bson/binary.py

@@ -208,7 +208,7 @@ class Binary(bytes):
       - `data`: the binary data to represent. Can be any bytes-like type
         that implements the buffer protocol.
       - `subtype` (optional): the `binary subtype
-        <http://bsonspec.org/#/specification>`_
+        <https://bsonspec.org/spec.html>`_
         to use
 
     .. versionchanged:: 3.9

doc/atlas.rst

@@ -35,7 +35,7 @@ Connections to Atlas require TLS/SSL.
 
   You can read more about TLS versions and their security implications here:
 
-  `<https://www.owasp.org/index.php/Transport_Layer_Protection_Cheat_Sheet#Rule_-_Only_Support_Strong_Protocols>`_
+  `<https://cheatsheetseries.owasp.org/cheatsheets/Transport_Layer_Protection_Cheat_Sheet.html#only-support-strong-protocols>`_
 
 .. _python.org: https://www.python.org/downloads/
 .. _homebrew: https://brew.sh/

doc/changelog.rst

@@ -1072,7 +1072,7 @@ Changes and Deprecations:
 - Deprecated the MongoClient option `socketKeepAlive`. It now defaults to true
   and disabling it is not recommended, see `does TCP keepalive time affect
   MongoDB Deployments?
-  <https://docs.mongodb.com/manual/faq/diagnostics/#does-tcp-keepalive-time-affect-mongodb-deployments>`_
+  <https://docs.mongodb.com/manual/faq/diagnostics/#does-tcp-keepalive-time-affect-mongodb-deployments->`_
 - Deprecated :meth:`~pymongo.collection.Collection.initialize_ordered_bulk_op`,
   :meth:`~pymongo.collection.Collection.initialize_unordered_bulk_op`, and
   :class:`~pymongo.bulk.BulkOperationBuilder`. Use

doc/conf.py

@@ -80,6 +80,13 @@
 # A list of ignored prefixes for module index sorting.
 # modindex_common_prefix = []
 
+# Options for link checking
+# The anchors on the rendered markdown page are created after the fact,
+# so this link results in a 404.
+linkcheck_ignore = [
+    "https://github.com/mongodb/specifications/blob/master/source/server-discovery-and-monitoring/server-monitoring.rst#requesting-an-immediate-check"
+]
+
 # -- Options for extensions ----------------------------------------------------
 autoclass_content = "init"
 

doc/developer/periodic_executor.rst

@@ -106,7 +106,7 @@ Thus the current design of periodic executors is surprisingly simple: they
 do a simple `time.sleep` for a half-second, check if it is time to wake or
 terminate, and sleep again.
 
-.. _Server Discovery And Monitoring Spec: https://github.com/mongodb/specifications/blob/master/source/server-discovery-and-monitoring/server-discovery-and-monitoring.rst#requesting-an-immediate-check
+.. _Server Discovery And Monitoring Spec: https://github.com/mongodb/specifications/blob/master/source/server-discovery-and-monitoring/server-monitoring.rst#requesting-an-immediate-check
 
 .. _PYTHON-863: https://jira.mongodb.org/browse/PYTHON-863
 

doc/examples/high_availability.rst

@@ -308,7 +308,7 @@ milliseconds of the closest member's ping time.
   replica set *through* a mongos. The equivalent is the localThreshold_ command
   line option.
 
-.. _localThreshold: http://docs.mongodb.org/manual/reference/mongos/#cmdoption--localThreshold
+.. _localThreshold: https://docs.mongodb.com/manual/reference/program/mongos/#std-option-mongos.--localThreshold
 
 .. _health-monitoring:
 

doc/examples/mod_wsgi.rst

@@ -3,7 +3,7 @@
 PyMongo and mod_wsgi
 ====================
 
-To run your application under `mod_wsgi <http://code.google.com/p/modwsgi/>`_,
+To run your application under `mod_wsgi <https://github.com/GrahamDumpleton/mod_wsgi/>`_,
 follow these guidelines:
 
 * Run ``mod_wsgi`` in daemon mode with the ``WSGIDaemonProcess`` directive.
@@ -48,9 +48,9 @@ interpreter.
 
 Python C extensions in general have issues running in multiple
 Python sub interpreters. These difficulties are explained in the documentation for
-`Py_NewInterpreter <http://docs.python.org/2/c-api/init.html#Py_NewInterpreter>`_
+`Py_NewInterpreter <https://docs.python.org/3/c-api/init.html#c.Py_NewInterpreter>`_
 and in the `Multiple Python Sub Interpreters
-<https://code.google.com/p/modwsgi/wiki/ApplicationIssues#Multiple_Python_Sub_Interpreters>`_
+<https://modwsgi.readthedocs.io/en/master/user-guides/application-issues.html#multiple-python-sub-interpreters>`_
 section of the ``mod_wsgi`` documentation.
 
 Beginning with PyMongo 2.7, the C extension for BSON detects when it is running

doc/examples/tailable.rst

@@ -5,7 +5,7 @@ By default, MongoDB will automatically close a cursor when the client has
 exhausted all results in the cursor. However, for `capped collections
 <https://docs.mongodb.org/manual/core/capped-collections/>`_ you may
 use a `tailable cursor
-<https://docs.mongodb.org/manual/reference/glossary/#term-tailable-cursor>`_
+<https://docs.mongodb.com/manual/core/tailable-cursors/>`_
 that remains open after the client exhausts the results in the initial cursor.
 
 The following is a basic example of using a tailable cursor to tail the oplog

doc/examples/tls.rst

@@ -32,7 +32,7 @@ MongoDB.
 
   You can read more about TLS versions and their security implications here:
 
-  `<https://www.owasp.org/index.php/Transport_Layer_Protection_Cheat_Sheet#Rule_-_Only_Support_Strong_Protocols>`_
+  `<https://cheatsheetseries.owasp.org/cheatsheets/Transport_Layer_Protection_Cheat_Sheet.html#only-support-strong-protocols>`_
 
 .. _python.org: https://www.python.org/downloads/
 .. _homebrew: https://brew.sh/