AsciiDoc Language issueshttps://gitlab.eclipse.org/eclipse/asciidoc-lang/asciidoc-lang/-/issues2023-02-28T02:08:40Zhttps://gitlab.eclipse.org/eclipse/asciidoc-lang/asciidoc-lang/-/issues/15Fix scope of abstract section style2023-02-28T02:08:40ZSarah WhiteFix scope of abstract section style*Original issue: https://github.com/asciidoctor/asciidoc-docs/issues/23*
*Published page: https://docs.asciidoctor.org/asciidoc/latest/sections/abstract/*
*Source page: https://gitlab.eclipse.org/eclipse/asciidoc-lang/asciidoc-lang/-...*Original issue: https://github.com/asciidoctor/asciidoc-docs/issues/23*
*Published page: https://docs.asciidoctor.org/asciidoc/latest/sections/abstract/*
*Source page: https://gitlab.eclipse.org/eclipse/asciidoc-lang/asciidoc-lang/-/blob/main/docs/modules/sections/pages/abstract.adoc?plain=1*
The documentation incorrectly states that the `abstract` style can only be applied to a section in the `article` doctype on the [Abstract (Section) page](https://docs.asciidoctor.org/asciidoc/latest/sections/abstract/). The abstract style can also be used on a section in the book doctype. In this case, it becomes a chapter, even if defined as a level-0 section (in a multipart book).
It does correctly note that it can be applied to `article` and `book` doctypes on the [Section Styles for Articles and Books page](https://docs.asciidoctor.org/asciidoc/latest/sections/styles/) The abstract style can also be used on a section in the book doctype. In this case, it becomes a chapter, even if defined as a level-0 section (in a multipart book).
Note the content commented out in the page:
```
////
There's some sort of funkiness with book and abstract so we're putting this section on hold.
== Book abstract syntax
When the document type is book, the `abstract` section style must be placed on the first section _inside_ the chapter section.
The section must be one section level below the chapter, that is, the chapter is marked up as level 1 (`==`) so its abstract must be marked up as level 2 (`===`).
An abstract may not be used _before_ a part or chapter in a book.
[source]
----
= Book Title
:doctype: book
== Chapter Title
[abstract]
=== Summary
Documentation is a distillation of many long adventures.
=== Section
----
////
```
This content needs to be reconciled as part of this issue. Is the section level information correct or not?
The PR for this issue should update the Abstract (Section) page to correctly describe the application and result of the `abstract` style on a section in both doctypes and reconcile the commented out content (remove it if it is incorrect or make sure any correct information in it is communicated in the new content).