Merge pull request #7773 from nicoddemus/xml-properties-xdist-docs

Warning about record_testsuite_property not working with xdist

(cherry picked from commit 4e460cd)

Author: bluetech

src/_pytest/junitxml.py

@@ -377,6 +377,12 @@ def test_foo(record_testsuite_property):
             record_testsuite_property("STORAGE_TYPE", "CEPH")
 
     ``name`` must be a string, ``value`` will be converted to a string and properly xml-escaped.
+
+    .. warning::
+
+        Currently this fixture **does not work** with the
+        `pytest-xdist <https://github.com/pytest-dev/pytest-xdist>`__ plugin. See issue
+        `#7767 <https://github.com/pytest-dev/pytest/issues/7767>`__ for details.
     """
 
     __tracebackhide__ = True