This documentation change improves the section on dangling comments in
the formatter.
---------
Co-authored-by: David Szotten <davidszotten@gmail.com>
Co-authored-by: Micha Reiser <micha@reiser.io>
I've written done my condensed learnings from working on the formatter
so that others can have an easier start working on it.
This is a pure docs change