[Demi-commits] r76 - docs

John Morrissey jwm-guest at costa.debian.org
Wed Feb 8 01:37:13 UTC 2006


Author: jwm-guest
Date: 2006-02-08 01:37:12 +0000 (Wed, 08 Feb 2006)
New Revision: 76

Modified:
   docs/CODING_STANDARDS
Log:
use tabs, alphabetize and group modules


Modified: docs/CODING_STANDARDS
===================================================================
--- docs/CODING_STANDARDS	2006-02-08 01:32:18 UTC (rev 75)
+++ docs/CODING_STANDARDS	2006-02-08 01:37:12 UTC (rev 76)
@@ -4,22 +4,30 @@
 letter and the remaining letters in lower case.
 
 
-Long Lines
-==========
-Wrap lines at 80 characters, including comments, unless code clarity is
-severaly impacted.
+Basic Formatting
+================
+Use tabs to indent code. Wrap lines at 80 characters, including comments,
+unless code clarity is severaly impacted. Use "double quotes" instead of
+'single quotes' around strings unless the string contains double quotes that
+would otherwise need to be escaped.
 
 
-String Quoting
-==============
+Importing
+=========
+Imports are divided into two groups: demi and non-demi. Alphabetize imports
+by module. For example:
 
-Use "double quotes" instead of 'single quotes' around strings unless
-the string contains double quotes that must be escaped.
+from random import randint
+from string import join, split, strip
 
+from remotecommand import RemoteCommand
 
+random and string are non-demi modules, so they're grouped first. Then,
+demi modules are listed.
+
+
 Docstrings
 ==========
-
 Always include docstrings for new classes and functions.
 
 




More information about the Demi-commits mailing list