more conventional python style (as per pep 8)
docs tweaks