Merge master into improve-sample-metadata-docs, keep detailed docs and add notes on lab cross samples

Author: Tanisha127

malariagen_data/anoph/sample_metadata.py

@@ -799,6 +799,17 @@ def clear_extra_metadata(self):
             requested. The returned DataFrame is a copy and can be safely modified
             without affecting internal caches.
         """,
+        notes="""
+            Some samples in the dataset are lab crosses — mosquitoes bred in
+            the laboratory that have no real collection date. These samples
+            use ``year=-1`` and ``month=-1`` as sentinel values. They may
+            cause unexpected results in date-based analyses (e.g.,
+            ``pd.to_datetime`` will fail on negative year values).
+
+            To exclude lab cross samples, use::
+
+                df = api.sample_metadata(sample_query="year >= 0")
+        """,
     )
     def sample_metadata(
         self,