Happy to help 🙂
As for description – I agree, we need to expand the documentation, will do that as soon as possible. There is short description of all common (i.e. global) shortcode attributes (including before and after) at the beginning of the Shortcodes section in description, but we definetely need to add more examples etc.