Fix barrier docs

The original comments weren't rendered correctly by Markdown.