There's a bunch of edge case behaviour with the way tags behave (especially the @example tag). We should have some kind of way of detecting this. Example with the midi bundle here, where the @function tag is being displayed as part of the code example.
Or here where the contents of the @link tag isn't being properly displayed.