ibzib commented on pull request #13815:
URL: https://github.com/apache/beam/pull/13815#issuecomment-767916507


   > Adjust the formatting of the markdown in the release guide to be 1 
sentence per line, rather than mix of that, 1 paragraph per line, and 80 char 
formatted. This makes reviewing later changes simpler, as new sentences appear 
as new lines, changes and removals as one would expect.
   
   The present inconsistency is annoying, but IMO putting each sentence on a 
new line decreases the readability of the source in many cases. I'd favor an 80 
or 100 character limit since it keeps the paragraph structure visibly intact in 
the source, and most importantly a computer can enforce it.
   
   In any case, there should be a website-wide consensus on this, and it should 
be checked automatically. Otherwise, it will take a Sisyphean effort to 
maintain without much benefit.


----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

For queries about this service, please contact Infrastructure at:
[email protected]


Reply via email to