PYTHON-5945 Note which otel tests will be superseded by PYTHON-5947

test_span_created_for_insert_and_find and test_query_text_included_when_configured
duplicate coverage the unified test format's find_without_query_text.yml/insert.yml
and find.yml will provide once operation-span support and the
expectTracingMessages runner land; flag them for removal at that point
rather than leaving the redundancy undocumented.

Author: blink1073

test/asynchronous/test_otel.py

@@ -74,6 +74,9 @@ def spans(self, name: str | None = None):
             return list(finished)
         return [s for s in finished if s.name == name]
 
+    # TODO(PYTHON-5947): once the unified test format runner supports
+    # expectTracingMessages/operation spans, this is superseded by the spec's
+    # find_without_query_text.yml and insert.yml.
     async def test_span_created_for_insert_and_find(self):
         client = await self.async_rs_or_single_client(tracing={"enabled": True})
         coll = client[self.db.name].test_otel
@@ -233,6 +236,9 @@ async def test_prose_2_command_payload_emission_via_env_var(self):
         self.assertEqual(len(spans), 1)
         self.assertNotIn("db.query.text", spans[0].attributes)
 
+    # TODO(PYTHON-5947): once the unified test format runner supports
+    # expectTracingMessages/operation spans, this is superseded by the spec's
+    # find.yml (db.query.text assertion).
     async def test_query_text_included_when_configured(self):
         client = await self.async_rs_or_single_client(
             tracing={"enabled": True, "query_text_max_length": 1000}

test/test_otel.py

@@ -74,6 +74,9 @@ def spans(self, name: str | None = None):
             return list(finished)
         return [s for s in finished if s.name == name]
 
+    # TODO(PYTHON-5947): once the unified test format runner supports
+    # expectTracingMessages/operation spans, this is superseded by the spec's
+    # find_without_query_text.yml and insert.yml.
     def test_span_created_for_insert_and_find(self):
         client = self.rs_or_single_client(tracing={"enabled": True})
         coll = client[self.db.name].test_otel
@@ -233,6 +236,9 @@ def test_prose_2_command_payload_emission_via_env_var(self):
         self.assertEqual(len(spans), 1)
         self.assertNotIn("db.query.text", spans[0].attributes)
 
+    # TODO(PYTHON-5947): once the unified test format runner supports
+    # expectTracingMessages/operation spans, this is superseded by the spec's
+    # find.yml (db.query.text assertion).
     def test_query_text_included_when_configured(self):
         client = self.rs_or_single_client(tracing={"enabled": True, "query_text_max_length": 1000})
         coll = client[self.db.name].test_otel