Merge "Add some guidance for group names"

This commit is contained in:
Jenkins 2014-10-23 22:33:41 +00:00 committed by Gerrit Code Review
commit ca15085ea8
2 changed files with 13 additions and 0 deletions

View File

@ -19,6 +19,7 @@ Contents
fixture
parser
exceptions
namespaces
styleguide
generator
contributing

12
doc/source/namespaces.rst Normal file
View File

@ -0,0 +1,12 @@
----------------------------------------------
Choosing group names for configuration options
----------------------------------------------
Applications should use a meaningful name without a prefix. For Oslo
libraries, when naming groups for configuration options using the
name of the library itself instead of a descriptive name to help avoid
collisions. If the library name is namespaced then use '_' as a separator
in the group name.
For example, the ``oslo.log`` library should use ``oslo_log`` as the
group name.