From 93e094f235052d81572aeff8aac49e1f26d1aad7 Mon Sep 17 00:00:00 2001
From: Ronny Pfannschmidt <opensource@ronnypfannschmidt.de>
Date: Sun, 6 Jun 2021 08:20:23 +0200
Subject: [PATCH] add docs for deprecation of Item/File inheritance

---
 doc/en/deprecations.rst | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/doc/en/deprecations.rst b/doc/en/deprecations.rst
index c3020fb9498..cf501d50921 100644
--- a/doc/en/deprecations.rst
+++ b/doc/en/deprecations.rst
@@ -42,6 +42,20 @@ As pytest tries to move off `py.path.local <https://py.readthedocs.io/en/latest/
 
 Pytest will provide compatibility for quite a while.
 
+Diamond inheritance between :class:`pytest.File` and :class:`pytest.Item`
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. deprecated:: 6.3
+
+Inheriting from both Item and file at once has never been supported officially,
+however some plugins providing linting/code analysis have been using this as a hack.
+
+This practice is now officially deprecated and a common way to fix this is `example pr fixing inheritance`_.
+
+
+
+.. _example pr fixing inheritance: https://github.com/asmeurer/pytest-flakes/pull/40/files
+
 
 Backward compatibilities in ``Parser.addoption``
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~