updates to descriptions
Merge pull request #2332 from hannesm/better-descriptions

updates to descriptions