Update to descriptions

More elaborate description and examples provided.