diff --git a/src/docbook/patterns/abstraction/collection.xml b/src/docbook/patterns/abstraction/collection.xml index ec77cc4..5fa0410 100644 --- a/src/docbook/patterns/abstraction/collection.xml +++ b/src/docbook/patterns/abstraction/collection.xml @@ -116,7 +116,7 @@ In this example the Collection Element was needed to establish a context for the exchange data. Without a collection element, this information would have to be - duplicated in every Stock element. + duplicated in every Stock element.
diff --git a/src/docbook/patterns/abstraction/optional-container.xml b/src/docbook/patterns/abstraction/optional-container.xml index bfdc9c7..b8cc6b9 100644 --- a/src/docbook/patterns/abstraction/optional-container.xml +++ b/src/docbook/patterns/abstraction/optional-container.xml @@ -13,23 +13,21 @@ When creating large DTDs with many logical units authors might be required to learn a - large number of these logical units to know how to use the DTD. By hiding the details of - optional parts of the DTD beneath optional elements, some of this complexity can be - reduced. + large number of these logical units to know how to use the DTD. + By hiding the details of optional parts of the DTD beneath optional elements, + some of this complexity can be reduced.
Problem - In a DTD with many logical units, an author of a document can be overwhelmed with the - number of choices that have to be made. + In a DTD with many logical units, an author of a document can be overwhelmed with the number of choices that have to be made.
Context - In large, general-purpose DTDs where many logical units are presented, and more than - one of the units is optional. The document will be authored by humans. + In large, general-purpose DTDs where many logical units are presented, and more than one of the units is optional. The document will be authored by humans.
@@ -129,9 +127,9 @@ ]]> - When generating an XBEL document, the info element is not required. This means that if - the author was never interested in creating an info element, he would not need to know - about the info element, the metadata element, or the owner attribute, thus eliminating 3 + When generating an XBEL document, the info element is not required. This means that if + the author was never interested in creating an info element, he would not need to know + about the info element, the metadata element, or the owner attribute, thus eliminating 3 logical units from what the author needs to learn.
diff --git a/src/docbook/patterns/consistency/common-attributes.xml b/src/docbook/patterns/consistency/common-attributes.xml index fec8cdf..d75219b 100644 --- a/src/docbook/patterns/consistency/common-attributes.xml +++ b/src/docbook/patterns/consistency/common-attributes.xml @@ -12,8 +12,7 @@ Common Attributes - Provide a set of attributes that can be placed on all, or most, elements in the - document type. + Provide a set of attributes that can be placed on all, or most, elements in the document type. @@ -127,10 +126,11 @@
Known Uses - The XMLspec DTD Common Attributes Chapter explains the use of Common Attributes in the - DTD. - XHTML defines a set of core attributes. These attributes are applied to almost every - element in the XHTML document type. The core attributes are defined like this: + The XMLspec DTD Common Attributes Chapter explains the use of Common Attributes in the DTD. + + XHTML defines a set of core attributes. + These attributes are applied to almost every element in the XHTML document type. + The core attributes are defined like this: - These two elements "Figure" and "Table" have very similar content + These two elements Figure and Table have very similar content and identical attribute lists. This makes it very easy for authors of the document. Once they have learned the structure of one of the elements, the other one will be easy to use. The more variation there is between the two, the easier it is to confuse the two @@ -68,10 +68,10 @@ The more consistent the structure of various elements is the easier it is to learn to use a document type. Subtle differences in structure can be particularly difficult to - learn. If, for example, in the above example, one of the "id" attributes was + learn. If, for example, in the above example, one of the id attributes was IMPLIED and the other one was REQUIRED, this would be a difficult distinction to remember. Users would constantly need to refer to the documentation to remind them which - element’s id was required and which one wasn’t. + element’s id was required and which one wasn’t.
Related Patterns @@ -100,8 +100,8 @@ - All four of the elements have identical content model. This helps enormously in - learning the specifics of this DTD. + All four of the elements have identical content model. + This helps enormously in learning the specifics of this DTD.
References diff --git a/src/docbook/patterns/flexibility/catch-all.xml b/src/docbook/patterns/flexibility/catch-all.xml index 7824d59..566eea2 100644 --- a/src/docbook/patterns/flexibility/catch-all.xml +++ b/src/docbook/patterns/flexibility/catch-all.xml @@ -48,8 +48,7 @@ Example - This example shows how a document that describes a car would allow a comment - element that includes elements from HTML. + This example shows how a document that describes a car would allow a comment element that includes elements from HTML. Pinto @@ -65,8 +64,7 @@ Example - To allow this type of inclusion using an XML Schema, use the any element as - follows: + To allow this type of inclusion using an XML Schema, use the any element as follows: diff --git a/src/docbook/patterns/metadata/head-body.xml b/src/docbook/patterns/metadata/head-body.xml index ab69c9b..919fee1 100644 --- a/src/docbook/patterns/metadata/head-body.xml +++ b/src/docbook/patterns/metadata/head-body.xml @@ -136,7 +136,7 @@ Known Uses HEAD and BODY elements in XHTML. - SOAP (Simple Object Access Protocol) uses Header and Body Elements inside an Envelope + SOAP (Simple Object Access Protocol) uses Header and Body Elements inside an Envelope element.