See doc comment guide: https://www.dartlang.org/articles/doc-comment-guidelines/#first-paragraph-a-one-sentence-description

First paragraph should be a single sentence.