Improve docstrings situation (a little, not too much)
Improve docstrings situation (a little, not too much)

Largely based on content from toms's modularization branch.

sknorr/suse-doc-style-checker,sknorr/suse-doc-style-checker,sknorr/suse-doc-style-checker