Each part of the public interface deserves some explanatory documentation comment.

Like what is the purpose of the (class, method), how to use it, what are the parameters.

Read more at https://www.dartlang.org/articles/style-guide/#comments