Tidy up Python code

[NiklasKeck]

The python code (feature sommelier) should be better documented (docstrings) and follow clear guidelines. These guidelines should furthermore be documented in the CONTRIBUTING doc.