Apply PEP8 to (most of) documentor.py

WARNING: Added a `TODO` to check implementation of an `A if check else B` construct that I think is currently always producing the same result... see comments to L64