Better comply to the "Guidelines for Dart Doc Comments"

See https://www.dartlang.org/articles/doc-comment-guidelines/

* First paragraph should be a "one-sentence" description.
* Class descriptions are **nound phrases**.
* Function/method descriptions begin with a **third-person verb**.