Add documentation for cyclic-import (#8322)

Co-authored-by: Jacob Walls <jacobtylerwalls@gmail.com>

doc/data/messages/c/cyclic-import/bad/bad.py

@@ -0,0 +1,8 @@
+def count_to_one():
+    return 1
+
+
+def count_to_three():
+    from .bad2 import count_to_two
+
+    return count_to_two() + 1

doc/data/messages/c/cyclic-import/bad/bad2.py

@@ -0,0 +1,5 @@
+from .bad import count_to_one  # [cyclic-import]
+
+
+def count_to_two():
+    return count_to_one() + 1

doc/data/messages/c/cyclic-import/details.rst

@@ -1 +1,3 @@
-You can help us make the doc better `by contributing <https://github.com/pylint-dev/pylint/issues/5953>`_ !
+The good code is just an example. There are various strategies to resolving
+cyclic imports and the best choice relies heavily on the context of the code
+and the affected modules.

doc/data/messages/c/cyclic-import/good.py

@@ -1 +1,10 @@
-# This is a placeholder for correct code for this message.
+def count_to_one():
+    return 1
+
+
+def count_to_two():
+    return count_to_one() + 1
+
+
+def count_to_three():
+    return count_to_two() + 1