diff --git a/changelog/3899.doc.rst b/changelog/3899.doc.rst new file mode 100644 index 000000000..675684a01 --- /dev/null +++ b/changelog/3899.doc.rst @@ -0,0 +1 @@ +Add note to ``plugins.rst`` that ``pytest_plugins`` should not be used as a name for a user module containing plugins. diff --git a/doc/en/plugins.rst b/doc/en/plugins.rst index 3d1226d34..c4961d0a4 100644 --- a/doc/en/plugins.rst +++ b/doc/en/plugins.rst @@ -86,6 +86,11 @@ which will import the specified module as a ``pytest`` plugin. :ref:`full explanation ` in the Writing plugins section. +.. note:: + The name ``pytest_plugins`` is reserved and should not be used as a + name for a custom plugin module. + + .. _`findpluginname`: Finding out which plugins are active