Regarding AsciiDoctor and long lines

[Daniel Ebdrup Jensen]

On Wed, Feb 10, 2021 at 02:57:34PM +0100, Andreas B wrote:
>Have you considered one sentence per line?
>
>Ref. https://asciidoctor.org/docs/asciidoc-recommended-practices/#one-sentence-per-line.
>
>Andreas
>
>On Wed, Feb 10, 2021 at 2:50 PM Daniel Ebdrup Jensen
><debdrup at freebsd.org> wrote:
>>
>> Hi folks,
>>
>> Pursuant to a conversation that was had on #bsddocs on EFnet, this is
>> mostly me wondering if we can adopt a new standard practice.
>>
>> Since the AsciiDoctor conversion, it's become evident that reading diffs
>> which exceed the usual 72 columns that FreeBSD has standardized on for
>> style(9) is less than great, especially as some of the sentences in the
>> documentation can be rather long.
>>
>> So I would love if it we can agree to wrap/justify lines to 72 columns,
>> going forward whenever we touch files.
>>
>> I've already started doing this on the handbook/x11 chapter update that
>> I'm working on, and it's in line with what we're used to from DocBook,
>> so I don't think it's too much of a big ask? :)
>>
>> We also need to decide about it relatively soon, since the Weblate
>> project needs to know about about it, as it involves their use of .so
>> files (although the details somewhat escaped me when I read it after
>> staying up all night, so perhaps a domain expert can fill in the blanks
>> here?).
>>
>> For reference, my testing had led me to believe that AsciiDoctor doesn't
>> care one bit how it's styled, as long as the actual markup is kept the
>> same.
>>
>> I'm open to feedback about it, of course, but it seems like a very
>> sensible change to me.
>>
>> Yours hopefully,
>> Daniel Ebdrup Jensen
>_______________________________________________
>freebsd-doc at freebsd.org mailing list
>https://lists.freebsd.org/mailman/listinfo/freebsd-doc
>To unsubscribe, send any mail to "freebsd-doc-unsubscribe at freebsd.org"

Sure, that seems like a nice compromise.

I mostly want some kind of consensus so we can move forward without
having to deal with these extremely long lines. ;)

Yours,
Daniel Ebdrup Jensen
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 614 bytes
Desc: not available
URL: <http://lists.freebsd.org/pipermail/freebsd-doc/attachments/20210210/ac97d078/attachment.sig>