[Bug 265246] AsciiDoctor primer: make AsciiDoc examples of lists less ambiguous

From: <bugzilla-noreply_at_freebsd.org>
Date: Sat, 16 Jul 2022 01:20:51 UTC
https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=265246

            Bug ID: 265246
           Summary: AsciiDoctor primer: make AsciiDoc examples of lists
                    less ambiguous
           Product: Documentation
           Version: Latest
          Hardware: Any
               URL: https://github.com/freebsd/freebsd-doc/blob/main/docum
                    entation/content/en/books/fdp-primer/asciidoctor-prime
                    r/_index.adoc#4-lists
                OS: Any
            Status: New
          Severity: Affects Some People
          Priority: ---
         Component: Books & Articles
          Assignee: doc@FreeBSD.org
          Reporter: grahamperrin@gmail.com

<https://www.freebsd.org/status/report-2022-01-2022-03/#_ports_collection> –
with bullet points not presented as such – might be the result of following the
second of these examples: 

<https://docs.freebsd.org/en/books/fdp-primer/book/#asciidoctor-ordered-lists>

<https://docs.freebsd.org/en/books/fdp-primer/book/#asciidoctor-unordered-lists>

Each example will be clearer if it includes a line of text preceding the first
listing, and – essentially – the blank line in between. 

A blank line, because
<https://docs.asciidoctor.org/asciidoc/latest/blocks/paragraphs/#create-a-paragraph>

> Adjacent or consecutive lines of text form a paragraph …

-- 
You are receiving this mail because:
You are the assignee for the bug.