update: Adressed even more @TomiBelan's comments

* Fixed various issues w.r.t. docstrings (''' on a separate line,
  grammar fixes, ...)

* Using google-style docstrings where possible.