[documentation-guide] Added a couple of bridgeheads to make the glossary more readable.

jhradile jhradile at fedoraproject.org
Sat Mar 22 19:00:19 UTC 2014


commit e85131aa84453b8edcafe0843df135da445539a5
Author: Jaromir Hradilek <jhradile at redhat.com>
Date:   Sat Mar 22 19:59:27 2014 +0100

    Added a couple of bridgeheads to make the glossary more readable.

 en-US/style.xml |  101 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 files changed, 101 insertions(+), 0 deletions(-)
---
diff --git a/en-US/style.xml b/en-US/style.xml
index 412665c..df017ef 100644
--- a/en-US/style.xml
+++ b/en-US/style.xml
@@ -281,6 +281,7 @@
 	</section>
 	<section id="sect-documentation_guide-style-word_usage">
 			<title>Word usage, capitalization, and spelling</title>
+      <bridgehead renderas="sect2">Symbols</bridgehead>
 			<variablelist>
 <varlistentry>
 	<term>%</term>
@@ -306,7 +307,11 @@ See percent.
 		</para>
 	</listitem>
 </varlistentry> 
+</variablelist>
 
+<bridgehead renderas="sect2">A</bridgehead>
+
+<variablelist>
 <varlistentry id="anchor-am">
 	<term>a.m.</term>
 	<listitem>
@@ -409,7 +414,11 @@ Assure suggests mental comfort. Example: <emphasis>I assured my future father-in
 		</para>
 	</listitem>
 </varlistentry>
+</variablelist>
+
+<bridgehead renderas="sect2">B</bridgehead>
 
+<variablelist>
 <varlistentry>
 	<term>backport</term>
 	<listitem>
@@ -589,7 +598,11 @@ Lists should always consist of more than two items. Use bullets for a list in wh
 		</para>
 	</listitem>
 </varlistentry>
+</variablelist>
 
+<bridgehead renderas="sect2">C</bridgehead>
+
+<variablelist>
 <varlistentry>
 	<term>can/may</term>
 	<listitem>
@@ -774,7 +787,11 @@ Use the following format: $1,500 USD, omitting <emphasis>USD</emphasis> if it is
 		</para>
 	</listitem>
 </varlistentry>
+</variablelist>
+
+<bridgehead renderas="sect2">D</bridgehead>
 
+<variablelist>
 <varlistentry>
 	<term>daisy chain</term>
 	<listitem>
@@ -907,7 +924,11 @@ Do not use DVD burner or CD burner (use CD writer in that case).
 		</para>
 	</listitem>
 </varlistentry>
+</variablelist>
 
+<bridgehead renderas="sect2">E</bridgehead>
+
+<variablelist>
 <varlistentry>
 	<term>e-book, e-business, e-commerce, e-learning</term>
 	<listitem>
@@ -1016,7 +1037,11 @@ Do not use them at the end of sentences. An exclamation point can be used when r
 		</para>
 	</listitem>
 </varlistentry>
+</variablelist>
+
+<bridgehead renderas="sect2">F</bridgehead>
 
+<variablelist>
 <varlistentry>
 	<term>failover (n.);</term>
 	<term>fail over (v.)</term>
@@ -1125,7 +1150,11 @@ Stands for file transfer protocol. You may actually need to refer to SFTP, secur
 		</para>
 	</listitem>
 </varlistentry>
+</variablelist>
+
+<bridgehead renderas="sect2">G</bridgehead>
 
+<variablelist>
 <varlistentry>
 	<term>g++</term>
 	<term>G++</term>
@@ -1249,7 +1278,11 @@ When referring to the command, use gdb. When referring to the program, use GDB.
 		</para>
 	</listitem>
 </varlistentry>
+</variablelist>
 
+<bridgehead renderas="sect2">H</bridgehead>
+
+<variablelist>
 <varlistentry>
 	<term>hard-coded (adj.)</term>
 	<term>hard code (v.)</term>
@@ -1399,7 +1432,11 @@ Also see <link linkend="anchor-bandwidth">bandwidth</link>.
 		</para>
 	</listitem>
 </varlistentry>
+</variablelist>
+
+<bridgehead renderas="sect2">I</bridgehead>
 
+<variablelist>
 <varlistentry>
 	<term>I/O</term>
 	<listitem>
@@ -1543,7 +1580,11 @@ Correct: SSH works with almost any kind of public key algorithm or encoding form
 		</para>
 	</listitem>
 </varlistentry>
+</variablelist>
+
+<bridgehead renderas="sect2">J</bridgehead>
 
+<variablelist>
 <varlistentry>
 	<term>just</term>
 	<listitem>
@@ -1552,7 +1593,11 @@ Use sparingly and avoid when possible. For example, in a phrase like, <emphasis>
 		</para>
 	</listitem>
 </varlistentry>
+</variablelist>
 
+<bridgehead renderas="sect2">K</bridgehead>
+
+<variablelist>
 <varlistentry>
 	<term>KB</term>
 	<listitem>
@@ -1585,7 +1630,11 @@ Use sparingly and avoid when possible. For example, in a phrase like, <emphasis>
 		</para>
 	</listitem>
 </varlistentry>
+</variablelist>
+
+<bridgehead renderas="sect2">L</bridgehead>
 
+<variablelist>
 <varlistentry id="anchor-later">
 	<term>later/newer</term>
 	<listitem>
@@ -1675,7 +1724,11 @@ When the bulleted list items complete a sentence or are sentences themselves, us
 		</para>
 	</listitem>
 </varlistentry>
+</variablelist>
+
+<bridgehead renderas="sect2">M</bridgehead>
 
+<variablelist>
 <varlistentry>
 	<term>man page</term>
 	<listitem>
@@ -1787,7 +1840,11 @@ Hyphenate words with the prefix <emphasis>multi</emphasis> unless the dictionary
 		</para>
 	</listitem>
 </varlistentry>
+</variablelist>
 
+<bridgehead renderas="sect2">N</bridgehead>
+
+<variablelist>
 <varlistentry>
 	<term>nameserver</term>
 	<listitem>
@@ -1876,7 +1933,11 @@ Lists should always consist of more than two items. Use bullets for a list in wh
 		</para>
 	</listitem>
 </varlistentry>
+</variablelist>
+
+<bridgehead renderas="sect2">O</bridgehead>
 
+<variablelist>
 <varlistentry>
 	<term>Objective C</term>
 	<listitem>
@@ -1984,7 +2045,11 @@ When referring to something quantifiable, use <emphasis>more than</emphasis> ins
 		</para>
 	</listitem>
 </varlistentry>
+</variablelist>
+
+<bridgehead renderas="sect2">P</bridgehead>
 
+<variablelist>
 <varlistentry>
 	<term>packet-switching</term>
 	<listitem>
@@ -2135,7 +2200,11 @@ Don’t use <emphasis>close proximity.</emphasis> It’s redundant.
 		</para>
 	</listitem>
 </varlistentry>
+</variablelist>
 
+<bridgehead renderas="sect2">Q</bridgehead>
+
+<variablelist>
 <varlistentry>
 	<term>quotations</term>
 	<listitem>
@@ -2147,7 +2216,11 @@ Place <emphasis>said</emphasis> first, followed by the name: <emphasis>Friends,
 		</para>
 	</listitem>
 </varlistentry>
+</variablelist>
+
+<bridgehead renderas="sect2">R</bridgehead>
 
+<variablelist>
 <varlistentry>
 	<term>regardless</term>
 	<listitem>
@@ -2249,7 +2322,11 @@ Pronoun and verb agreement: A company is singular in the US. In other words, Red
 		</para>
 	</listitem>
 </varlistentry>
+</variablelist>
+
+<bridgehead renderas="sect2">S</bridgehead>
 
+<variablelist>
 <varlistentry>
 	<term>screenshot</term>
 	<listitem>
@@ -2461,7 +2538,11 @@ Use the two-letter postal abbreviations. See stateabbreviations.us for a list.
 		</para>
 	</listitem>
 </varlistentry>
+</variablelist>
 
+<bridgehead renderas="sect2">T</bridgehead>
+
+<variablelist>
 <varlistentry>
 	<term>taskbar</term>
 	<listitem>
@@ -2578,7 +2659,11 @@ The word <emphasis>this</emphasis> can be used as an adjective or a pronoun. If
 		</para>
 	</listitem>
 </varlistentry>
+</variablelist>
+
+<bridgehead renderas="sect2">U</bridgehead>
 
+<variablelist>
 <varlistentry>
 	<term>under</term>
 	<listitem>
@@ -2671,7 +2756,11 @@ Avoid this term. Write <emphasis>use</emphasis> instead.
 		</para>
 	</listitem>
 </varlistentry>
+</variablelist>
+
+<bridgehead renderas="sect2">V</bridgehead>
 
+<variablelist>
 <varlistentry>
 	<term>vi, Vim</term>
 	<listitem>
@@ -2687,7 +2776,11 @@ Avoid this term. Write <emphasis>use</emphasis> instead.
 		</para>
 	</listitem>
 </varlistentry>
+</variablelist>
 
+<bridgehead renderas="sect2">W</bridgehead>
+
+<variablelist>
 <varlistentry>
 	<term>Web 2.0</term>
 	<listitem>
@@ -2744,7 +2837,11 @@ Avoid using this term.
 		</para>
 	</listitem>
 </varlistentry>
+</variablelist>
+
+<bridgehead renderas="sect2">X</bridgehead>
 
+<variablelist>
 <varlistentry>
 	<term>x86</term>
 	<listitem>
@@ -2768,7 +2865,11 @@ Avoid using this term.
 		</para>
 	</listitem>
 </varlistentry>
+</variablelist>
+
+<bridgehead renderas="sect2">Z</bridgehead>
 
+<variablelist>
 <varlistentry>
 	<term>ZIP code</term>
 	<listitem>


More information about the docs-commits mailing list