docs: Document lack of support for Numpydoc Methods sections

pawamoy · Maximiliano Greco · pawamoy · commit 37a60006b73b · 2022-02-18T20:16:14.000+01:00
Co-authored-by: Maximiliano Greco &lt;mmngreco@users.noreply.github.com&gt;
diff --git a/docs/usage.md b/docs/usage.md
@@ -88,6 +88,12 @@ both globally or per autodoc instruction.
 
 See the supported docstring sections on [Griffe's documentation](https://mkdocstrings.github.io/griffe/docstrings/).
 
+!!! note
+    As Numpy-style is partially supported by the underlying parser,
+    you may experience problems in the building process if your docstring
+    has a `Methods` section in the class docstring
+    (see [#366](https://github.com/mkdocstrings/mkdocstrings/issues/366)).
+
 #### Google-style admonitions
 
 With Google-style docstrings, any section that is not recognized will be transformed into its admonition equivalent.
