copied from PyCogent scripting guidelines, with some edits
added another guideline pulled from the 'creating' document
first pass through this full document