summaryrefslogtreecommitdiff
path: root/doc/source/developing.rst
diff options
context:
space:
mode:
Diffstat (limited to 'doc/source/developing.rst')
-rw-r--r--doc/source/developing.rst34
1 files changed, 34 insertions, 0 deletions
diff --git a/doc/source/developing.rst b/doc/source/developing.rst
index 95a04073..c5092cc0 100644
--- a/doc/source/developing.rst
+++ b/doc/source/developing.rst
@@ -173,3 +173,37 @@ or
.. code-block:: bash
$ pip install -e .
+
+Standardize Import Format
+=========================
+
+.. _`Import Order Guide`: http://docs.openstack.org/developer/hacking/#imports
+
+The import order shows below:
+
+* {{stdlib imports in human alphabetical order}}
+* \n
+* {{third-party lib imports in human alphabetical order}}
+* \n
+* {{project imports in human alphabetical order}}
+* \n
+* \n
+* {{begin your code}}
+
+Example
+~~~~~~~
+
+.. code-block:: python
+
+ import copy
+ import fixtures
+ import mock
+ import os
+
+ from osc_lib.api import auth
+ from osc_lib import utils
+ import six
+
+ from openstackclient import shell
+ from openstackclient.tests import utils
+