Extended docs for shortcode handling and doctypes (fixes #1700)