Edit "About this guide" for semantic line feeds

[pierwill]

This is a small PR to demonstrate what work toward #1241 looks like.

[jyn514]

This LGTM, but I'd like to run this by @spastorino or @JohnTitor before making a large change - do you think #1241 is a good idea?

[pierwill]

Using #1132 for discussion per @JohnTitor.

[JohnTitor]

The idea itself sounds great to me. But Ralf said:

The change doesn't have to happen all at once; when existing text is changed one could encourage also changing it to the new format.

this makes sense to me, otherwise, the transition would be diff-noisy. However, it raises another concern, "do we have to ask contributors to follow that change each time?". To reduce our work, we could implement a style checker e.g. getting git-diff and checking if each line ends with . or ,.
I'm not sure which one is better so I'd like to see your thoughts.

[pierwill]

The change doesn't have to happen all at once; when existing text is changed one could encourage also changing it to the new format.

I agree!

I'm not sure about automated checking. Lines need not end in a , or .; : works as well. So does no punctuation for certain long sentences. Sometimes splitting at "and" or "but" or "therefore" makes sense.

If they're too much noise, we don't have to do PRs like this one. However, doing this kind of formatting often helps catch typos, confusing sentences, etc.

[pierwill]

do we have to ask contributors to follow that change each time?

This could be case-by-case. For a small change, I'd say no. But if a contributor is doing more substantial editing or writing, I think it'd be okay to ask they follow this style.

[jyn514]

👍 I think this is fine to merge as is and we can add automated checking in a separate PR if necessary.