diff --git a/en-US/Book_Design.xml b/en-US/Book_Design.xml index d182a6d..77196bb 100644 --- a/en-US/Book_Design.xml +++ b/en-US/Book_Design.xml @@ -112,11 +112,18 @@ The term "introduction" on its own is sufficiently vague, and raises enough questions in translation and with translation memory (TM) tools, that Red Hat technical documentation does not use this term on its own. Instead, use the phrase "Introduction to $productname" near the beginning of the book to introduce the reader to the product. Do not use "Introduction" to introduce the book; that is the task of the Abstract. A further benefit of this usage is that the same introduction can be used across various books to introduce the same product. + +
+ Placement of Headings + + Do not include two consecutive headings without intervening text. Each heading must be followed by one or more paragraphs of text. If it is difficult to provide meaningful intervening text, then consider whether one of the headings is unnecessary. + +
Unused Heading Titles - - This section lists various heading titles that might be used in Red Hat technical documentation, but that should be avoided except in specific circumstances. + + This section lists various heading titles that might be used in Red Hat technical documentation, but that should be avoided except in specific circumstances. Overview