tabish121 commented on PR #6101: URL: https://github.com/apache/artemis/pull/6101#issuecomment-3639207093
> We manually wrapped our previous mark-down docs which was extremely tedious and prone to mess up. Lines with no wrapping are a pain to scroll down and read. Soft wrapping is an option in some cases, but not all. > > The sentence-per-line convention is a balance of the two options, and [it's recommended by the AsciiDoc folks](https://asciidoctor.org/docs/asciidoc-recommended-practices/#one-sentence-per-line) for a number of reasons. > > For what it's worth, I've not found the process to be a hindrance or an annoyance. Is there something specific that's "god awful"? 😆 I won't ever remember to do it, so will always have to go back and do it as I apparently will now, and reading it either involves endless scrolling for long sentences or a jumbled mess if you use auto wrap. In any case I will mark this as draft and try and find some motivation to fix it later. -- 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. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected] --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
