Sam Rawlins
9f85dc07a7
Fixes https://github.com/dart-lang/sdk/issues/29804 Start doc comment with a single-sentence summary. https://dart.dev/guides/language/effective-dart/documentation#do-start-doc-comments-with-a-single-sentence-summary Separate the first sentence of a doc comment into its own paragraph. https://dart.dev/guides/language/effective-dart/documentation#do-separate-the-first-sentence-of-a-doc-comment-into-its-own-paragraph Replace text which refers to "using" an "invocation" of a member with text which refers to "referencing" a member. Explicitly call out mixins and superclass constraints. Improve language around using "this" as a receiver. Attempt to use more straightfoward sentences. Change-Id: Ib465b640c217d3759455611116aef0545b5665fc Reviewed-on: https://dart-review.googlesource.com/c/sdk/+/201445 Commit-Queue: Samuel Rawlins <srawlins@google.com> Reviewed-by: Brian Wilkerson <brianwilkerson@google.com> Reviewed-by: Konstantin Shcheglov <scheglov@google.com>