Add documentation for using-final-decorator-in-unsupported-version (#6583)

mbyrnepr2 · Pierre-Sassoulas · DanielNoord · web-flow · commit 4cc1d8d14cb3 · 2022-05-12T16:05:59.000+02:00
Co-authored-by: Pierre Sassoulas &lt;pierre.sassoulas@gmail.com&gt;
Co-authored-by: Daniël van Noord &lt;13665637+DanielNoord@users.noreply.github.com&gt;
diff --git a/doc/data/messages/u/using-final-decorator-in-unsupported-version/bad.py b/doc/data/messages/u/using-final-decorator-in-unsupported-version/bad.py
@@ -0,0 +1,8 @@
+from typing import final
+
+
+@final  # [using-final-decorator-in-unsupported-version]
+class Playtypus(Animal):
+    @final  # [using-final-decorator-in-unsupported-version]
+    def lay_egg(self):
+        ...
diff --git a/doc/data/messages/u/using-final-decorator-in-unsupported-version/details.rst b/doc/data/messages/u/using-final-decorator-in-unsupported-version/details.rst
@@ -0,0 +1,2 @@
+The message is emitted when the ``final`` decorator is used with a Python version less than 3.8.
+The ``final`` decorator was introduced in Python version 3.8.
diff --git a/doc/data/messages/u/using-final-decorator-in-unsupported-version/good.py b/doc/data/messages/u/using-final-decorator-in-unsupported-version/good.py
@@ -0,0 +1,3 @@
+class Playtypus(Animal):
+    def lay_egg(self):
+        ...
diff --git a/doc/data/messages/u/using-final-decorator-in-unsupported-version/related.rst b/doc/data/messages/u/using-final-decorator-in-unsupported-version/related.rst
@@ -0,0 +1 @@
+- `PEP 591 <https://peps.python.org/pep-0591/#the-final-decorator>`_

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,2 @@`
	`1`	+The message is emitted when the ``final`` decorator is used with a Python version less than 3.8.
	`2`	+The ``final`` decorator was introduced in Python version 3.8.
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	`+class Playtypus(Animal):`
	`2`	`+ def lay_egg(self):`
	`3`	`+ ...`
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1 @@`
	`1`	+- `PEP 591 <https://peps.python.org/pep-0591/#the-final-decorator>`_