Most doc-comments use markdown-style `'s, and, unless you're indicating something very specific with the ['s, I don't think there's a need to be inconsistent with the rest of the code-base.