CXX-3114 Fix and update references to Markdown MongoDB specifications (#1229)

Author: eramongodb

src/mongocxx/include/mongocxx/v_noabi/mongocxx/events/command_failed_event.hpp

@@ -32,7 +32,7 @@ namespace events {
 /// An event notification sent when the driver fails to execute a MongoDB command.
 ///
 /// @see
-/// - "CommandFailedEvent" in https://github.com/mongodb/specifications/blob/master/source/command-logging-and-monitoring/command-logging-and-monitoring.rst
+/// - "CommandFailedEvent" in https://github.com/mongodb/specifications/blob/master/source/command-logging-and-monitoring/command-logging-and-monitoring.md
 ///
 class command_failed_event {
    public:

src/mongocxx/include/mongocxx/v_noabi/mongocxx/events/command_started_event.hpp

@@ -32,7 +32,7 @@ namespace events {
 /// An event notification sent when the driver begins executing a MongoDB command.
 ///
 /// @see
-/// - "CommandStartedEvent" in https://github.com/mongodb/specifications/blob/master/source/command-logging-and-monitoring/command-logging-and-monitoring.rst
+/// - "CommandStartedEvent" in https://github.com/mongodb/specifications/blob/master/source/command-logging-and-monitoring/command-logging-and-monitoring.md
 ///
 class command_started_event {
    public:

src/mongocxx/include/mongocxx/v_noabi/mongocxx/events/command_succeeded_event.hpp

@@ -32,7 +32,7 @@ namespace events {
 /// An event notification sent when the driver successfully executes a MongoDB command.
 ///
 /// @see
-/// - "CommandSucceededEvent" in https://github.com/mongodb/specifications/blob/master/source/command-logging-and-monitoring/command-logging-and-monitoring.rst
+/// - "CommandSucceededEvent" in https://github.com/mongodb/specifications/blob/master/source/command-logging-and-monitoring/command-logging-and-monitoring.md
 ///
 class command_succeeded_event {
    public:

src/mongocxx/include/mongocxx/v_noabi/mongocxx/events/heartbeat_failed_event.hpp

@@ -32,7 +32,7 @@ namespace events {
 /// status of a server.
 ///
 /// @see
-/// - "ServerHeartbeatFailedEvent" in https://github.com/mongodb/specifications/blob/master/source/server-discovery-and-monitoring/server-discovery-and-monitoring.rst
+/// - "ServerHeartbeatFailedEvent" in https://github.com/mongodb/specifications/blob/master/source/server-discovery-and-monitoring/server-discovery-and-monitoring.md
 ///
 class heartbeat_failed_event {
    public:

src/mongocxx/include/mongocxx/v_noabi/mongocxx/events/heartbeat_started_event.hpp

@@ -31,7 +31,7 @@ namespace events {
 /// status of a server.
 ///
 /// @see
-/// - "ServerHeartbeatStartedEvent" in https://github.com/mongodb/specifications/blob/master/source/server-discovery-and-monitoring/server-discovery-and-monitoring.rst
+/// - "ServerHeartbeatStartedEvent" in https://github.com/mongodb/specifications/blob/master/source/server-discovery-and-monitoring/server-discovery-and-monitoring.md
 ///
 class heartbeat_started_event {
    public:

src/mongocxx/include/mongocxx/v_noabi/mongocxx/events/heartbeat_succeeded_event.hpp

@@ -30,7 +30,7 @@ namespace events {
 /// of a server.
 ///
 /// @see
-/// - "ServerHeartbeatSucceededEvent" in https://github.com/mongodb/specifications/blob/master/source/server-discovery-and-monitoring/server-discovery-and-monitoring.rst
+/// - "ServerHeartbeatSucceededEvent" in https://github.com/mongodb/specifications/blob/master/source/server-discovery-and-monitoring/server-discovery-and-monitoring.md
 ///
 class heartbeat_succeeded_event {
    public:

src/mongocxx/include/mongocxx/v_noabi/mongocxx/events/server_changed_event.hpp

@@ -32,7 +32,7 @@ namespace events {
 /// connected to.
 ///
 /// @see
-/// - "ServerDescriptionChangedEvent" in https://github.com/mongodb/specifications/blob/master/source/server-discovery-and-monitoring/server-discovery-and-monitoring.rst
+/// - "ServerDescriptionChangedEvent" in https://github.com/mongodb/specifications/blob/master/source/server-discovery-and-monitoring/server-discovery-and-monitoring.md
 ///
 class server_changed_event {
    public:

src/mongocxx/include/mongocxx/v_noabi/mongocxx/events/server_closed_event.hpp

@@ -32,7 +32,7 @@ namespace events {
 /// from the topology description.
 ///
 /// @see
-/// - "ServerClosedEvent" in https://github.com/mongodb/specifications/blob/master/source/server-discovery-and-monitoring/server-discovery-and-monitoring.rst
+/// - "ServerClosedEvent" in https://github.com/mongodb/specifications/blob/master/source/server-discovery-and-monitoring/server-discovery-and-monitoring.md
 ///
 class server_closed_event {
    public:

src/mongocxx/include/mongocxx/v_noabi/mongocxx/events/server_opening_event.hpp

@@ -31,7 +31,7 @@ namespace events {
 /// and begins monitoring it.
 ///
 /// @see
-/// - "ServerOpeningEvent" in https://github.com/mongodb/specifications/blob/master/source/server-discovery-and-monitoring/server-discovery-and-monitoring.rst
+/// - "ServerOpeningEvent" in https://github.com/mongodb/specifications/blob/master/source/server-discovery-and-monitoring/server-discovery-and-monitoring.md
 ///
 class server_opening_event {
    public:

src/mongocxx/include/mongocxx/v_noabi/mongocxx/events/topology_changed_event.hpp

@@ -31,7 +31,7 @@ namespace events {
 /// connected to or a change in the overall server topology.
 ///
 /// @see
-/// - "TopologyDescriptionChangedEvent" in https://github.com/mongodb/specifications/blob/master/source/server-discovery-and-monitoring/server-discovery-and-monitoring.rst
+/// - "TopologyDescriptionChangedEvent" in https://github.com/mongodb/specifications/blob/master/source/server-discovery-and-monitoring/server-discovery-and-monitoring.md
 ///
 class topology_changed_event {
    public:

src/mongocxx/include/mongocxx/v_noabi/mongocxx/events/topology_closed_event.hpp

@@ -29,7 +29,7 @@ namespace events {
 /// description.
 ///
 /// @see
-/// - "TopologyClosedEvent" in https://github.com/mongodb/specifications/blob/master/source/server-discovery-and-monitoring/server-discovery-and-monitoring.rst
+/// - "TopologyClosedEvent" in https://github.com/mongodb/specifications/blob/master/source/server-discovery-and-monitoring/server-discovery-and-monitoring.md
 ///
 class topology_closed_event {
    public:

src/mongocxx/include/mongocxx/v_noabi/mongocxx/events/topology_opening_event.hpp

@@ -30,7 +30,7 @@ namespace events {
 /// An event notification sent when the driver initializes a server topology.
 ///
 /// @see
-/// - "TopologyOpeningEvent" in https://github.com/mongodb/specifications/blob/master/source/server-discovery-and-monitoring/server-discovery-and-monitoring.rst
+/// - "TopologyOpeningEvent" in https://github.com/mongodb/specifications/blob/master/source/server-discovery-and-monitoring/server-discovery-and-monitoring.md
 ///
 class topology_opening_event {
    public:

src/mongocxx/test/client_side_encryption.cpp

@@ -2080,7 +2080,7 @@ TEST_CASE("KMS TLS Options Tests", "[client_side_encryption][!mayfail]") {
     }
 }
 
-// https://github.com/mongodb/specifications/blob/master/source/client-side-encryption/tests/README.rst#test-setup
+// https://github.com/mongodb/specifications/blob/master/source/client-side-encryption/tests/README.md#test-setup
 std::tuple<mongocxx::client_encryption, mongocxx::client> _setup_explicit_encryption(
     bsoncxx::document::view key1_document, mongocxx::client* key_vault_client) {
     mongocxx::client client{
@@ -2164,7 +2164,7 @@ std::tuple<mongocxx::client_encryption, mongocxx::client> _setup_explicit_encryp
     return std::make_tuple(std::move(client_encryption), std::move(encrypted_client));
 }
 
-// https://github.com/mongodb/specifications/blob/master/source/client-side-encryption/tests/README.rst
+// https://github.com/mongodb/specifications/blob/master/source/client-side-encryption/tests/README.md
 TEST_CASE("Explicit Encryption", "[client_side_encryption]") {
     instance::current();
 

src/mongocxx/test/gridfs/bucket.cpp

@@ -70,7 +70,7 @@ void validate_gridfs_file(database db,
             stdx::string_view(expected_file_name));
 
     // md5 is deprecated in GridFS, we don't include it:
-    // https://github.com/mongodb/specifications/blob/master/source/gridfs/gridfs-spec.rst
+    // https://github.com/mongodb/specifications/blob/master/source/gridfs/gridfs-spec.md
     REQUIRE(!files_doc->view()["md5"]);
 
     std::int32_t index = 0;

src/mongocxx/test/spec/unified_tests/runner.cpp

@@ -942,7 +942,7 @@ void assert_error(const mongocxx::operation_exception& exception,
         // in assert_error():
         // See
         //
-    "https://github.com/mongodb/specifications/blob/master/source/unified-test-format/unified-test-format.rst#expectederror":
+    "https://github.com/mongodb/specifications/blob/master/source/unified-test-format/unified-test-format.md#expectederror":
         // A substring of the expected error message (e.g. "errmsg" field in a server error
         // document). The test runner MUST assert that the error message contains this string using
         // a case-insensitive match.
@@ -1374,7 +1374,7 @@ TEST_CASE("index management spec automated tests", "[unified_format_specs]") {
 }
 
 // See:
-// https://github.com/mongodb/specifications/blob/master/source/client-side-encryption/client-side-encryption.rst
+// https://github.com/mongodb/specifications/blob/master/source/client-side-encryption/client-side-encryption.md
 TEST_CASE("client side encryption unified format spec automated tests", "[unified_format_specs]") {
     CLIENT_SIDE_ENCRYPTION_ENABLED_OR_SKIP();
     run_unified_format_tests_in_env_dir("CLIENT_SIDE_ENCRYPTION_UNIFIED_TESTS_PATH");