Style, readability and docstrings

[Timothy Grant]

Hi again.

I posted a little code sample the other day and got a couple of comments
back on my "python style". One of those comments suggested that I move
my function comment headers blocks into docstrings.

I have done so, and now I can barely read my code, I don't know what it
is about those comment blocks at the top of a function that my eyes
like, but without my function header comment blocks, my eyes don't
immediately pick up each function as I scroll through my code.

Is this a "You need to retrain your eyes" type thing? Have other's
noticed the same thing, and does anyone have a nice coding style that
works for them that I can borrow?

###########################################################
# Stand Fast,
#    tjg.
#
Chief Technology Officer              tjg at exceptionalminds.com
Red Hat Certified Engineer            www.exceptionalminds.com
Avalon Technology Group, Inc.                   (503) 246-3630
>>>>>>>>>>>>Linux...Because rebooting isn't normal<<<<<<<<<<<<