diff --git a/spec/modules/ROOT/pages/paragraph.adoc b/spec/modules/ROOT/pages/paragraph.adoc index e704a87f87ad2b7f351f9583de0ac92428313c7d..34c37941978b421e2b6084034f494613021de3b6 100644 --- a/spec/modules/ROOT/pages/paragraph.adoc +++ b/spec/modules/ROOT/pages/paragraph.adoc @@ -3,9 +3,9 @@ == Description Paragraphs are a foundational structure in AsciiDoc. -A *paragraph* is a simple, implicit block consisting of a run of contiguous non-interrupting lines that can contain inline elements and uninterpreted text. +A *paragraph* is a simple, implicit block consisting of a run of contiguous, non-interrupting lines that consist of inline elements, preprocessor directives, and uninterpreted text. If a line isn't recognized as another block element or structural form, it's assumed to be a paragraph. -Unrecognized syntax or syntax not allowed inside a paragraph is treated as text and isn't dropped. +Unrecognized syntax, or syntax not allowed inside a paragraph, is treated as uninterpreted text and isn't dropped. === Source examples @@ -42,7 +42,7 @@ A paragraph must accept: //// A paragraph must not be empty. -It may parse to empty in the case it contains an inline preprocessor directive that resolves to empty. +It can parse to empty if it contains an inline preprocessor directive that resolves to empty. A paragraph must be interrupted by: @@ -55,7 +55,7 @@ A paragraph must be interrupted by: === Attributes and metadata -A paragraph must accept the following attributes and metadata: +A paragraph can accept the following attributes and metadata: * Block title (title line and named attribute) * id (named and shorthand forms)