updated documentation with more examples as well as commented out orphaned ref shortcode.