Do documentation comments trump this? http://www.dartlang.org/articles/doc-comment-guidelines/#first-paragraph-a-one-sentence-description