No markup in shortdesc

The example parser and index template don't handle markup in the shortdesc element.  Use the docs element instead.

Now that we have Node as a dependency, I'd like to propose that we move our examples into templates with YAML front matter (for things like tags, classes used, description) and have a Node based task to build the examples.  I'd like to unify how we build the examples and rest of the website.  And I also think it makes sense to have these tasks (and the documentation building) run on Node - since this is a JavaScript project, I think we should all be able to contribute to JavaScript build tools.  I know this is a different subject than the ticket at hand, but all the copy/paste in the examples is getting to me.