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 <debd...@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@freebsd.org mailing list https://lists.freebsd.org/mailman/listinfo/freebsd-doc To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"
