Using a doc comment instead of a regular comment enables dartdoc to find it and generate documentation for it.
/// The number of characters in this chunk when unsplit.
int get length => ...
You are allowed to use most markdown formatting in your doc comments and dartdoc will process it accor...