Editing issues for new contributors

noatamir · noatamir · commit a89131e6f54c · 2022-08-11T19:48:37.000+02:00
diff --git a/doc/devel/contributing.rst b/doc/devel/contributing.rst
@@ -38,14 +38,16 @@ These are well documented issues, that do not require a deep understanding of
 the internals of Matplotlib. The issues may additionally be tagged with a
 difficulty. ``Difficulty: Easy`` is suited for people with little Python experience.
 ``Difficulty: Medium`` and ``Difficulty: Hard`` require more programming experience.
-This could be for a variety of reasons, among them:
- - The issue might be in areas of the code base which have more interdependencies,
-   or legacy code.
- - It could involve code for which the current maintainers can't offer much guidance,
-   or expertise.
- - It could also be less clearly defined tasks, which require some independent
-   exploration, making suggestions, or follow-up discussions to clarify a good path
-   to resolve the issue.
+This could be for a variety of reasons, among them, though not necessarily all at
+the same time:
+
+- The issue is in areas of the code base which have more interdependencies,
+  or legacy code.
+- It has less clearly defined tasks, which require some independent
+  exploration, making suggestions, or follow-up discussions to clarify a good path
+  to resolve the issue.
+- It involves python features such as decorators and context managers, which
+  have subtleties due to our implementation decisions.
 
 In general, the Matplotlib project does not assign issues. Issues are
 "assigned" or "claimed" by opening a PR; there is no other assignment
