[Bug 4069] Updating References for Use of xml:id

http://www.w3.org/Bugs/Public/show_bug.cgi?id=4069





------- Comment #1 from monica.martin@sun.com  2006-12-20 22:30 -------
http://www.w3.org/Bugs/Public/show_bug.cgi?id=4069 (Original issue)

UPDATED ISSUE AND PROPOSAL
Note, the updated proposal only specifies changes in the Primer.

=============
Title: Updating References for Use of xml:id
Target: Primer [1]
Description and Justification:
Issue #3752 and #3560 [2] introduced and clarified the use of xml:id.
Currently, no example using xml:id exists in any WG document, with only the
reference in Framework, Section 4.2 Policy Identification. The use of xml:id
could be clarified and properly constrained in the Primer document.  With the
addition of xml:id, its use can be described there, and account for constraints
and warnings. Any changes should taken into consideration expressed WG concerns
raised in the resolution of #3560. [2]

Proposal:
Section 2.8 Referencing Policy Expressions

a. Change from:
A policy expression may be identified by an IRI and referenced for
re-use as a standalone policy or within another policy expression.
There are two mechanisms to identify a policy expression: the wsu:Id
and Name attributes. A PolicyReference element can be used to
reference a policy expression identified using either of these
mechanisms.

Change to:
A policy expression may be identified by an IRI and referenced for
re-use as a standalone policy or within another policy expression.
There are three mechanisms to identify a policy expression: the
wsu:Id, xml:id and Name attributes. A PolicyReference element can be
used to reference a policy expression identified using either of
these mechanisms.

b. Change from: 
See Example 2-12

Change to:
[Add new paragraph and example under Example 2-12 at the end of the sentence:
"...|(|The absolute IRI is formed by combining the document IRI, |#| and the
value of the |wsu:Id| attribute.)]

In addition in Example 2-12, Contoso could have used either the xml:id or
wsu:Id. An example of the use of xml:id similar to that of wsu:Id is shown in
Example 2-13.

   <Policy xml:id="common">
    <mtom:OptimizedMimeSerialization wsp:Optional="true"/>
    <wsap:UsingAddressing />
   </Policy>

Conditions and constraints on the use of the |xml:id| attribute in conjunction
with Canonical XML 1.0 are specified in Appendix C of xml:id Version 1.0 [XML
ID
<http://dev.w3.org/cvsweb/%7Echeckout%7E/2006/ws/policy/ws-policy-framework.html?content-type=text/html;%20charset=utf-8#XMLID>]
and are further detailed in [C14N 1.0 Note
<http://dev.w3.org/cvsweb/%7Echeckout%7E/2006/ws/policy/ws-policy-framework.html?content-type=text/html;%20charset=utf-8#C14NNOTE>].
Significant care is suggested in the use of xml:id.

[Note: This new example would necessitate the renumbering of current Examples
2-13 to 2-16 in Section 2.8 to 2-14 to 2-17. There are no changes to any other
examples in this section or the text other that specified above.]

Section 3.2 Normal Form for Policy Expressions (now Section 3.6)
Change from:
If the referenced policy expression is in the same XML document as
the reference, then the policy expression should be identified using
the |wsu:Id| (XML ID) attribute and referenced using an IRI
reference to this XML ID value.

Change to:
If the referenced policy expression is in the same XML document as
the reference, then the policy expression should be identified using
the |wsu:Id|xml:id (XML ID) attribute and referenced using an IRI
reference to this XML ID value.

Reason: This is really clean up from Issue 3752,
http://www.w3.org/Bugs/Public/show_bug.cgi?id=3752. This is also
consistent with text in Section 4.3.4 Policy References in the
Framework ("This attribute references a policy expression by an IRI.
For a policy expression within the same XML Document, the reference
SHOULD be an IRI-reference to a policy expression identified by an
|ID|.").

[Note: As Issue 3965 was accepted, this text would be updated in new Section
3.6, Primer.]

Guidelines Document
No changes are proposed for Guidelines, Section 5.1 although they may be
considered in the future.

References:
[1] Primer
http://dev.w3.org/cvsweb/~checkout~/2006/ws/policy/ws-policy-primer.html?content-type=text/html;%20charset=utf-8#Referencing_Policy_Expressions
[2] Issues list: http://www.w3.org/Bugs/Public/show_bug.cgi?id=3752,
http://www.w3.org/Bugs/Public/show_bug.cgi?id=3560

Received on Wednesday, 20 December 2006 22:31:04 UTC