Generally, PEP 8 applies. We are using tabs-only for indentation. Line continuation indentation _shall_not_ line up with any opening characters in the line above. Simply indent it twice (so that it doesn't look like part of the following block, if any) and move on. docstrings are good. We should do more of those. Feel free to use doctest. Our test stuite will pick those up and run them. Caps are like PEP 8. ===== Begin example.py ===== """ example.py does . For example: >>> exposed_fn(3) None """ import os import sys import logging import turbogears import cherrypy from turbogears import widgets, validate, validators from naked_planning import model, controllers def exposed_fn(fn_arg): local_var = fn_arg class SomeClass(object): class_attrib = 'nonsense!' _hidden_attrib = ['line %s' % i for i in xrange(3, 93)] def exposed_method(self, fn_arg): some_var = fn_arg def _hidden_fn(self): self.some_field = 3 + 3 ===== End example.py =====