RFR: Extend documentation regarding logging [v2]

Johan Sjölen jsjolen at openjdk.org
Wed Sep 21 11:43:09 UTC 2022


On Wed, 21 Sep 2022 02:04:46 GMT, David Holmes <dholmes at openjdk.org> wrote:

>> I did it to increase readability while editing, and I didn't see a difference when reading the rendered product. Feels like there's some reasoning I'm missing here.
>
> Starting each sentence on a new line seems a very personal style choice - ref:
> https://groups.google.com/g/pandoc-discuss/c/tEWDWL2mLBY?pli=1
> It probably helps if also trying to maintain maximum line lengths, as editing may need fewer lines to be rewrapped. But personally I find it jarring to read.

Okay, this is probably a consequence of my editor being set up for coding and not for text editing then :-).

-------------

PR: https://git.openjdk.org/guide/pull/91


More information about the guide-dev mailing list