I have added usage comments in the heads of my (relevant) shortcodes. You can see the comment in the youtube.html shortcode below: This is not only useful for developers, but is also instructing our own CMS ( Usecue CMS) on how to insert these shortcodes. The usage example is read from the comment by the CMS and an insert button is added to the CMS editor field.
