[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