diff --git a/specification/common/reuse-w-lwdita/reuse-example.dita b/specification/common/reuse-w-lwdita/reuse-example.dita index 8a1818ef..e33bd9d9 100644 --- a/specification/common/reuse-w-lwdita/reuse-example.dita +++ b/specification/common/reuse-w-lwdita/reuse-example.dita @@ -4,7 +4,25 @@ <xmlelement>example</xmlelement> An example illustrates the subject of the topic or a portion of the topic. - + +
+ Usage information +

For maximum flexibility in creating specializations, examples allow + plain text as well as phrase and block level elements. Because of the way XML grammars are + defined within a DTD, any element that allows plain text cannot restrict the order or + frequency of other elements. As a result, the example element + allows title to appear anywhere as a child of + example. However, the intent of the specification is that + title only be used once in any example, + and when used, that it precede any other text or element content.

+
+
+ Rendering expectations +

Processors SHOULD treat the presence of more than one title element + in a example element as an error.

+ +
Attributes

diff --git a/specification/langRef/base/example.dita b/specification/langRef/base/example.dita index 55077b49..71256aa5 100644 --- a/specification/langRef/base/example.dita +++ b/specification/langRef/base/example.dita @@ -8,6 +8,8 @@ +

+
Example

The following code sample shows an example element that contains a