diff --git a/en-US/Translation.xml b/en-US/Translation.xml
index 361f504..c0cfaa1 100644
--- a/en-US/Translation.xml
+++ b/en-US/Translation.xml
@@ -10,16 +10,107 @@
Sentence Structure
-
- Using Lists Correctly
+
+ This section helps to describe how to construct your content for clarity and readability.
+ A full discussion of this topic is beyond the scope of this guide.
+
+
+
+ Using and Formatting Lists
- Lists appear in a range of formats, such as series, ordered, unordered (itemized), and so on. Avoid using itemized lists to format a single sentence. Some translation tools, such as Zanata, display list items and the introductory sentence (or sentence stem) as individual sentences for translation. If these are not complete sentences, they can be difficult to translate.
+ Lists appear in a range of formats, such as series, ordered, unordered (itemized), and so on. Avoid using itemized lists to format a single sentence. Some translation tools display list items and the introductory sentence (or sentence stem) as individual sentences for translation. If these are not complete sentences, they can be difficult to translate.
-
-
-
- Use an ordered list when the order of entries is important, or if you need to refer to one of the entries from elsewhere in your document.
-
+
+ The following general guidelines apply to lists:
+
+
+
+ Itemized lists
+
+
+ These appear as a bulleted list.
+ Use this list type for three or more entries where order is not important, or in a demonstration section when students are encouraged to not perform steps but to watch the instructor instead.
+ Titles are optional.
+
+
+
+
+ Ordered lists
+
+
+ These appear as a numbered list.
+ Use this list type for multiple entries if you need to refer to one of the entries from elsewhere in your document, or where order is important.
+ For example, if you need to list the order of operations required to prepare for an installation, or list a sequence of events that occurs.
+ Titles are optional.
+
+
+
+
+ Variable lists
+
+
+ These appear as a list of terms followed by definitions.
+ Use this list type to list and describe a series of terms, such as variables, command options or arguments, and similar items.
+ Titles are optional.
+ (This list is written as a variable list.)
+ A variable list is often preferable to a table, because tables have the additional overhead of calculating column width for every translation.
+ Tables are best reserved for information that relies upon, or benefits greatly from, a grid layout.
+
+
+
+
+ Procedures
+
+
+ These appear as a list of numbered steps.
+ Procedures always include a title, and are used to list the steps required to achieve a task.
+
+
+
+
+
+ You can nest lists, but try to keep the number of levels to two or fewer.
+ To nest procedures in DocBook, use <substep> elements.
+
+ Formatting Lists for Readability
+
+ It is important to provide sufficient spacing between elements in your documents to facilitate reading and comprehension.
+ You can include a lot of information in a few short paragraphs but readers need to be able to process that information in chunks.
+ The same applies to lists.
+ If you use DocBook to build itemized, ordered, or variable (definition) lists, you can use the or attributes to specify the spacing between list items.
+ DocBook uses the spacing attribute by default.
+
+
+ Use a list with normal spacing if any list item contains the following:
+
+
+
+
+ Nested lists.
+ Note that nested lists themselves can use the attribute if they fall outside the bounds of these recommendations.
+
+
+
+
+ Navigation or similar instructions (such as "Navigate to Menu -> Submenu").
+
+
+
+
+ Multiple paragraphs, or sentences that wrap to two or more lines.
+
+
+
+
+ Use a list with compact spacing in all other cases.
+
+
+
+ The use of all but very simple graphics in lists is strongly discouraged.
+
+
+
+
The following discussion provides some initial insight into using lists correctly. See The IBM Style Guide for a full discussion.
@@ -87,13 +178,15 @@
-
+
+
+
+ Noun Stacking
Modifier strings (modifier + noun + noun sentence format), over-modified nouns (or noun stacks), are especially difficult to translate, particularly when several different combinations could make sense.
-