Improve UnfoldSim Docstrings

[jschepers]

Here we can list Doc strings that need to be revised either because they are unclear or incomplete or because their formatting is not correct or inconsistent. Afterwards, we can also have a look at the code to see whether any doc strings are missing for exported functions.