The example documentation should not be restricted to 1/3 of the row unless there is something else consuming the other 2/3.
The text in `shortdesc` is shown on the example index page. It shouldn't have any markup in it.