add docs for other prose tests

Author: blink1073

test/asynchronous/test_client_bulk_write.py

@@ -84,6 +84,7 @@ async def test_formats_write_error_correctly(self):
 
 
 # https://github.com/mongodb/specifications/tree/master/source/crud/tests
+# Note: tests 1 and 2 are in test_read_write_concern_spec.py
 class TestClientBulkWriteCRUD(AsyncIntegrationTest):
     async def asyncSetUp(self):
         await super().asyncSetUp()
@@ -582,6 +583,8 @@ async def test_upserted_result(self):
         self.assertEqual(result.update_results[1].did_upsert, True)
         self.assertEqual(result.update_results[2].did_upsert, False)
 
+    # Note: test 14 is optional and intentionally no implemented because we do provide multiple APIs to specify explain.
+
     @async_client_context.require_version_min(8, 0, 0, -24)
     async def test_15_unacknowledged_write_across_batches(self):
         listener = OvertCommandListener()

test/asynchronous/test_read_write_concern_spec.py

@@ -180,6 +180,8 @@ async def test_raise_wtimeout(self):
             WriteConcern(w=async_client_context.w, wtimeout=1), WTimeoutError
         )
 
+    # https://github.com/mongodb/specifications/tree/master/source/crud/tests
+    # Test 1 (included here instead of test_client_bulk_write.py)
     @async_client_context.require_failCommand_fail_point
     async def test_error_includes_errInfo(self):
         expected_wce = {
@@ -214,6 +216,8 @@ async def test_error_includes_errInfo(self):
             }
             self.assertEqual(ctx.exception.details, expected_details)
 
+    # https://github.com/mongodb/specifications/tree/master/source/crud/tests
+    # Test 2 (included here instead of test_client_bulk_write.py)
     @async_client_context.require_version_min(4, 9)
     async def test_write_error_details_exposes_errinfo(self):
         listener = OvertCommandListener()

test/test_client_bulk_write.py

@@ -84,6 +84,7 @@ def test_formats_write_error_correctly(self):
 
 
 # https://github.com/mongodb/specifications/tree/master/source/crud/tests
+# Note: tests 1 and 2 are in test_read_write_concern_spec.py
 class TestClientBulkWriteCRUD(IntegrationTest):
     def setUp(self):
         super().setUp()
@@ -578,6 +579,8 @@ def test_upserted_result(self):
         self.assertEqual(result.update_results[1].did_upsert, True)
         self.assertEqual(result.update_results[2].did_upsert, False)
 
+    # Note: test 14 is optional and intentionally no implemented because we do provide multiple APIs to specify explain.
+
     @client_context.require_version_min(8, 0, 0, -24)
     def test_15_unacknowledged_write_across_batches(self):
         listener = OvertCommandListener()

test/test_read_write_concern_spec.py

@@ -178,6 +178,8 @@ def test_raise_wtimeout(self):
         self.disable_replication(client_context.client)
         self.assertWriteOpsRaise(WriteConcern(w=client_context.w, wtimeout=1), WTimeoutError)
 
+    # https://github.com/mongodb/specifications/tree/master/source/crud/tests
+    # Test 1 (included here instead of test_client_bulk_write.py)
     @client_context.require_failCommand_fail_point
     def test_error_includes_errInfo(self):
         expected_wce = {
@@ -212,6 +214,8 @@ def test_error_includes_errInfo(self):
             }
             self.assertEqual(ctx.exception.details, expected_details)
 
+    # https://github.com/mongodb/specifications/tree/master/source/crud/tests
+    # Test 2 (included here instead of test_client_bulk_write.py)
     @client_context.require_version_min(4, 9)
     def test_write_error_details_exposes_errinfo(self):
         listener = OvertCommandListener()