diff --git a/documentation/content/en/books/fdp-primer/structure/_index.adoc b/documentation/content/en/books/fdp-primer/structure/_index.adoc --- a/documentation/content/en/books/fdp-primer/structure/_index.adoc +++ b/documentation/content/en/books/fdp-primer/structure/_index.adoc @@ -147,9 +147,16 @@ The books are written in AsciiDoc. -The books are organized as an AsciiDoc `book`. -The books are divided into ``part``s, each of which contains several ``chapter``s. -``chapter``s are further subdivided into sections (`=`) and subsections (`==`, `===`) and so on. +For each FreeBSD book, the AsciiDoc document type (aka doctype) is `book`. +Books have ``part``s, each of which contains several ``chapter``s. + +When the document is converted to HTML 5 (using the built-in `html5` backend): + +* AsciiDoc section level 0 (`=`) at the beginning of a ``chapter`` of a `book` will be `

` +* AsciiDoc section level 1 (`==`) must be used for the first logical section of a chapter, and will be `

` +* AsciiDoc section level 2 (`===`) must be used for the first logical subsection, and will be `

` + +– and so on. Reference: link:https://docs.asciidoctor.org/asciidoc/latest/sections/titles-and-levels/[Section Titles and Levels | Asciidoctor Docs]. [[structure-document-books-physical]] === Physical Organization