Minor, but the `shortdesc` should not contain markup (given the way it is currently rendered in the example index.  The longer `doc` item below can contain markup.