Skip to content

Commit

Permalink
Let abstracts replace hightlight sections
Browse files Browse the repository at this point in the history
  • Loading branch information
cwickert committed Dec 10, 2021
1 parent caedc76 commit 758037b
Showing 1 changed file with 1 addition and 36 deletions.
37 changes: 1 addition & 36 deletions xml/docu_styleguide.outline.xml
Original file line number Diff line number Diff line change
Expand Up @@ -205,46 +205,11 @@
</para>
</formalpara>
</listitem>
<listitem>
<formalpara>
<title>Highlights</title>
<para>
Use a highlights section to summarize the information provided in a
chapter in four or fewer bullet points. Summarize the topic instead
of summarizing the outline.
</para>
</formalpara>
<example xml:id="ex-highlight">
<title>A highlights section</title>
<para>
This chapter will:
</para>
<itemizedlist>
<listitem>
<para>
Give you an overview over the file systems available in
<phrase role="productname">&suse; Linux Enterprise</phrase>, such
as Ext3, Ext4, and Btrfs.
</para>
</listitem>
<listitem>
<para>
Inform you about their distinctive advantages and disadvantages.
</para>
</listitem>
<listitem>
<para>
Help you choose the right one for your purpose.
</para>
</listitem>
</itemizedlist>
</example>
</listitem>
<listitem>
<formalpara>
<title>Introduction</title>
<para>
Provide introductory information directly after the highlights.
Provide introductory information directly after the abstract.
Do not place it in a separate section.
</para>
</formalpara>
Expand Down

0 comments on commit 758037b

Please sign in to comment.