Improve code according to Pylint recommendations

[muellerberndt]

• Add docstrings
• Break up long lines
• Change some implementation details
• (...)