[DOC beta] Fix code highlight and add missing YUIDoc markup
Merge pull request #3980 from tricknotes/fix-docs

[DOC beta] Fix code highlight and add missing YUIDoc markup