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
```python
default = ('"{0}"' if '"' not in default else "'{0}'").format(default)
```
wrong quotes...