Improve documentation

This description might be a bit cryptic, I am happy to rephrase if you don't like it and help me finding a better wording...