add pydocstyle

[jasmainak]

In most of the other projects I contribute to, we use pydocstyle to check conformity to PEP257. Once #259 is in, we can enable it by simply switching the line $ make flake to $ make pep. It's just a lot of errors, so it can be done when we are bored :)