Annotation fixes for @constructor

Annotation comment should be before @tag info, and a few of markdown fixes.