Wording in section 3.3

Section 3.3 Model

1) Minor editorial issue: capitalization should be "model", matching the
capitalization of the element name described, as throughout the rest of the
document.

2) Clarification needed: For the sentences:

"Hence, model elements occur before the user interaction markup."
and
"The content of element model is typically not rendered."

It is unclear whether these sentences are talking about XHTML+XForms or the
general case of an arbitrary containing document that allows XForms
elements. Further, the sentences seem to be statements or observations, not
imposing any suggestion or guideline for an author of an XForms-containing
document profile.


Suggest adding a section in the "Document Structure" chapter called
"Containing Documents", that gives firm guidance to future XYZ+XForms
document profile authors. The section should include the above sentences,
recast along the following lines:

"XForms Processors may require that model elements only occur before the
user interaction markup, and thus a containing document should enforce this
ordering on XForms elements."
and
"The content of element model is typically not rendered, and thus a
containing document should accept model elements at a position where they
will not be rendered."

Since there are unthinkably many possible containing document types, these
statements are "should" (not "must"), to allow for cases where the guideline
simply can't be met.

An example of how both of these guidelines are met by placing <xforms:model>
inside <html:head> might be helpful here.

Thanks,

.micah

Received on Tuesday, 22 January 2002 16:15:23 UTC