From 3389906b017613820e3af4f828b46007a5dd8f94 Mon Sep 17 00:00:00 2001 From: Eugene Platonov Date: Tue, 18 Feb 2014 23:11:59 -0500 Subject: [PATCH] explicitly disapprove plugins using default package --- src/sphinx/Extending/Plugins-Best-Practices.rst | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/src/sphinx/Extending/Plugins-Best-Practices.rst b/src/sphinx/Extending/Plugins-Best-Practices.rst index df72f825c..eeafba4c7 100644 --- a/src/sphinx/Extending/Plugins-Best-Practices.rst +++ b/src/sphinx/Extending/Plugins-Best-Practices.rst @@ -16,6 +16,12 @@ Specifically: Here are some current plugin best practices. **NOTE:** Best practices are evolving, so check back frequently. +Don't use default package +--------------------------- + +Users who have their build files in some package will not be able to +use your plugin if it's defined in default (no-name) package. + Avoid overriding `settings` -----------------------------