<html><head></head><body style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space; ">Thanks to the LC for considering this guideline, now approved after discussion and requests for revision in today's LC meeting. Please let me know if you see any problems with its current form.<div><br></div><div>(Oliver, the UMA WG would indeed like to request <b><a href="http://docs.kantarainitiative.org/uma/">http://docs.kantarainitiative.org/uma/</a></b> ! Thanks in advance.)</div><div><br></div><div><span class="Apple-tab-span" style="white-space:pre">        </span>Eve<br><div><br></div><div><a href="http://kantarainitiative.org/confluence/display/LC/Temporary+URL+Labeling+in+Technical+Specifications">http://kantarainitiative.org/confluence/display/LC/Temporary+URL+Labeling+in+Technical+Specifications</a></div><div><br></div><div><span class="Apple-style-span" style="font-family: Helvetica, Arial, sans-serif; font-size: 13px; line-height: 17px; "><div class="panelMacro" style="margin-top: 10px; margin-right: 20px; margin-bottom: 10px; margin-left: 20px; overflow-x: hidden; overflow-y: hidden; "><table class="infoMacro" style="font-size: 10pt; line-height: 13pt; color: rgb(0, 0, 0); font-weight: normal; clear: left; background-color: rgb(216, 228, 241); text-align: left; padding-top: 0px; padding-right: 20px; padding-bottom: 0px; padding-left: 20px; width: 753px; "><colgroup><col width="24"><col></colgroup><tbody><tr style="font-size: 10pt; line-height: 13pt; color: rgb(0, 0, 0); font-weight: normal; "><td valign="top" style="font-size: 1em; line-height: 13pt; color: rgb(0, 0, 0); font-weight: normal; padding-top: 14px; padding-right: 0px; padding-bottom: 14px; padding-left: 0px; border-top-style: none; border-right-style: none; border-bottom-style: none; border-left-style: none; border-width: initial; border-color: initial; "><img width="16" height="16" align="absmiddle" alt="" border="0" id="64f24496-e85c-4cd8-8144-a58e4f1a74bf" apple-width="yes" apple-height="yes" src="cid:FD79F94F-EA22-45BF-AA06-9AD0457891DB@promanage-inc.com"></td><td style="font-size: 1em; line-height: 13pt; color: rgb(0, 0, 0); font-weight: normal; padding-top: 14px; padding-right: 0px; padding-bottom: 14px; padding-left: 0px; border-top-style: none; border-right-style: none; border-bottom-style: none; border-left-style: none; border-width: initial; border-color: initial; "><b>Approved Guideline</b><br>Approved by the LC on&nbsp;<a href="http://kantarainitiative.org/confluence/display/LC/LC+telecon+2011-08-31" class="external-link" rel="nofollow" style="color: rgb(90, 141, 147); ">31 Aug 2011</a>.</td></tr></tbody></table></div><h2 style="line-height: normal; font-weight: bold; padding-top: 0px; padding-right: 0px; padding-bottom: 0px; padding-left: 0px; font-size: 18pt; margin-top: 32px; margin-right: 0px; margin-bottom: 4px; margin-left: 0px; color: rgb(90, 141, 147); border-bottom-color: rgb(193, 215, 46); "><a name="TemporaryURLLabelinginTechnicalSpecifications-TemporaryURLLabelinginTechnicalSpecifications"></a>Temporary URL Labeling in Technical Specifications</h2><div><a href="http://kantarainitiative.org/confluence/display/LC/Temporary+URL+Labeling+in+Technical+Specifications#TemporaryURLLabelinginTechnicalSpecifications-Requirements" style="color: rgb(90, 141, 147); ">Requirements</a>&nbsp;|&nbsp;<a href="http://kantarainitiative.org/confluence/display/LC/Temporary+URL+Labeling+in+Technical+Specifications#TemporaryURLLabelinginTechnicalSpecifications-LCGuideline" style="color: rgb(90, 141, 147); ">LC Guideline</a>&nbsp;|&nbsp;<a href="http://kantarainitiative.org/confluence/display/LC/Temporary+URL+Labeling+in+Technical+Specifications#TemporaryURLLabelinginTechnicalSpecifications-References" style="color: rgb(90, 141, 147); ">References</a></div><h3 style="line-height: normal; font-weight: bold; padding-top: 0px; padding-right: 0px; padding-bottom: 0px; padding-left: 0px; font-size: 15pt; margin-top: 28px; margin-right: 0px; margin-bottom: 4px; margin-left: 0px; color: rgb(90, 141, 147); "><a name="TemporaryURLLabelinginTechnicalSpecifications-Requirements"></a>Requirements</h3><p style="font-size: 10pt; line-height: 13pt; color: rgb(0, 0, 0); font-weight: normal; margin-top: 10px; margin-right: 0px; margin-bottom: 10px; margin-left: 0px; padding-top: 0px; padding-right: 0px; padding-bottom: 0px; padding-left: 0px; ">Kantara Work Groups that produce Technical Specifications often need to give unique labels to various components in those specifications, such as XML namespace names, or identifiers for fields in XRD descriptive data. Although these labels are intended to be temporary until the specs are eventually completed at a standards development organization (SDO), software implementers often need to code features that use these draft labels in the interim.</p><p style="font-size: 10pt; line-height: 13pt; color: rgb(0, 0, 0); font-weight: normal; margin-top: 10px; margin-right: 0px; margin-bottom: 10px; margin-left: 0px; padding-top: 0px; padding-right: 0px; padding-bottom: 0px; padding-left: 0px; ">Uniform Resource Identifiers (URIs), most often Uniform Resource Locators (URLs) using the&nbsp;<tt>http:</tt>&nbsp;scheme, are typically used for such labels. In some cases, it's desirable to allow machine-readable metadata, such as a schema, to be retrieved from the URL.</p><p style="font-size: 10pt; line-height: 13pt; color: rgb(0, 0, 0); font-weight: normal; margin-top: 10px; margin-right: 0px; margin-bottom: 10px; margin-left: 0px; padding-top: 0px; padding-right: 0px; padding-bottom: 0px; padding-left: 0px; ">Kantara Work Groups have control of URLs that reside in the wiki area assigned to them (for example,<tt><a href="http://kantarainitiative.org/confluence/display/uma/" class="external-link" rel="nofollow" style="color: rgb(90, 141, 147); ">http://kantarainitiative.org/confluence/display/uma/</a>...</tt>&nbsp;for the UMA Work Group), but using such URLs has two downsides:</p><ul style="font-size: 10pt; line-height: 13pt; list-style-type: disc; "><li style="font-size: 10pt; line-height: 13pt; margin-top: 0px; margin-right: 0px; margin-bottom: 0px; margin-left: 0px; padding-top: 0px; padding-right: 0px; padding-bottom: 0px; padding-left: 0px; ">Wiki areas are managed by the Confluence software in a proprietary fashion, and it's difficult to place "unencumbered" metadata at such locations.</li><li style="font-size: 10pt; line-height: 13pt; margin-top: 0px; margin-right: 0px; margin-bottom: 0px; margin-left: 0px; padding-top: 0px; padding-right: 0px; padding-bottom: 0px; padding-left: 0px; ">The URLs are longer than strictly necessary, making code examples difficult to read.</li></ul><p style="font-size: 10pt; line-height: 13pt; color: rgb(0, 0, 0); font-weight: normal; margin-top: 10px; margin-right: 0px; margin-bottom: 10px; margin-left: 0px; padding-top: 0px; padding-right: 0px; padding-bottom: 0px; padding-left: 0px; ">Following is an example from the&nbsp;<a href="http://kantarainitiative.org/confluence/display/uma/UMA+1.0+Core+Protocol" class="external-link" rel="nofollow" style="color: rgb(90, 141, 147); ">UMA 1.0 Core Protocol</a>&nbsp;as of 31 Aug 2011, illustrating the need for labels in its XRD formats (it had invented these URL strings in the absence of a Kantara policy):</p><div class="code panel" style="color: black; padding-top: 0px; padding-right: 0px; padding-bottom: 0px; padding-left: 0px; margin-top: 10px; margin-right: 20px; margin-bottom: 10px; margin-left: 20px; background-image: initial; background-attachment: initial; background-origin: initial; background-clip: initial; background-color: rgb(255, 255, 255); border-top-width: 1px; border-right-width: 1px; border-bottom-width: 1px; border-left-width: 1px; border-top-style: dashed; border-right-style: dashed; border-bottom-style: dashed; border-left-style: dashed; overflow-x: auto; overflow-y: auto; border-top-color: rgb(193, 215, 46); border-right-color: rgb(193, 215, 46); border-bottom-color: rgb(193, 215, 46); border-left-color: rgb(193, 215, 46); background-position: initial initial; background-repeat: initial initial; "><div class="codeContent panelContent" style="background-image: initial; background-attachment: initial; background-origin: initial; background-clip: initial; background-color: rgb(255, 255, 255); color: rgb(0, 0, 0); margin-top: 0px; margin-right: 0px; margin-bottom: 0px; margin-left: 0px; padding-top: 12px; padding-right: 10px; padding-bottom: 12px; padding-left: 10px; text-align: left; font-size: 0.95em; background-position: initial initial; background-repeat: initial initial; "><pre class="code-java" style="padding-top: 0px; padding-right: 0px; padding-bottom: 0px; padding-left: 0px; margin-top: 0px; margin-right: 0px; margin-bottom: 0px; margin-left: 0px; text-align: left; overflow-x: auto; overflow-y: auto; font-family: 'Courier New', Courier, monospace; line-height: 1.3; ">&lt;!-- Applies to both hosts and requesters --&gt;

&lt;Property
  type=<span class="code-quote" style="color: rgb(0, 145, 0); background-color: inherit; ">"http:<span class="code-comment" style="color: rgb(128, 128, 128); background-color: inherit; ">//kantarainitiative.org/ns/uma/1.0/token_formats"</span>&gt;artifact
</span>&lt;/Property&gt;
&lt;Property
  type=<span class="code-quote" style="color: rgb(0, 145, 0); background-color: inherit; ">"http:<span class="code-comment" style="color: rgb(128, 128, 128); background-color: inherit; ">//kantarainitiative.org/ns/uma/1.0/claim_formats"</span>&gt;claims2
</span>&lt;/Property&gt;

&lt;!-- Host protection API --&gt;

&lt;!-- AM as authorization server to host-as-client --&gt;
&lt;Link
  rel=<span class="code-quote" style="color: rgb(0, 145, 0); background-color: inherit; ">"http:<span class="code-comment" style="color: rgb(128, 128, 128); background-color: inherit; ">//kantarainitiative.org/ns/uma/1.0/host_token_uri"</span>
</span>  href=<span class="code-quote" style="color: rgb(0, 145, 0); background-color: inherit; ">"https:<span class="code-comment" style="color: rgb(128, 128, 128); background-color: inherit; ">//am.example.com/host/token_uri"</span>&gt;
</span>&lt;/Link&gt;
&lt;Link
  rel=<span class="code-quote" style="color: rgb(0, 145, 0); background-color: inherit; ">"http:<span class="code-comment" style="color: rgb(128, 128, 128); background-color: inherit; ">//kantarainitiative.org/ns/uma/1.0/host_user_uri"</span>
</span>  href=<span class="code-quote" style="color: rgb(0, 145, 0); background-color: inherit; ">"https:<span class="code-comment" style="color: rgb(128, 128, 128); background-color: inherit; ">//am.example.com/host/user_uri"</span>&gt;
</span>&lt;/Link&gt;
...
</pre></div></div><h3 style="line-height: normal; font-weight: bold; padding-top: 0px; padding-right: 0px; padding-bottom: 0px; padding-left: 0px; font-size: 15pt; margin-top: 28px; margin-right: 0px; margin-bottom: 4px; margin-left: 0px; color: rgb(90, 141, 147); "><a name="TemporaryURLLabelinginTechnicalSpecifications-LCGuideline"></a>LC Guideline</h3><p style="font-size: 10pt; line-height: 13pt; color: rgb(0, 0, 0); font-weight: normal; margin-top: 10px; margin-right: 0px; margin-bottom: 10px; margin-left: 0px; padding-top: 0px; padding-right: 0px; padding-bottom: 0px; padding-left: 0px; ">Kantara will make available the following area on its site that Work Groups can use for temporary URL-based labels that appear in their Technical Specifications and, optionally, web resources that correspond to these labels:&nbsp;<tt><a href="http://docs.kantarainitiative.org/" class="external-link" rel="nofollow" style="color: rgb(90, 141, 147); ">http://docs.kantarainitiative.org/</a></tt>.</p><p style="font-size: 10pt; line-height: 13pt; color: rgb(0, 0, 0); font-weight: normal; margin-top: 10px; margin-right: 0px; margin-bottom: 10px; margin-left: 0px; padding-top: 0px; padding-right: 0px; padding-bottom: 0px; padding-left: 0px; ">Each Work Group will, by request to Kantara staff, be given the opportunity to control URLs and content in an area named with the same affix given to their Confluence wiki area (or a modified affix by mutual arrangement). For example, the UMA Work Group could request<tt><a href="http://docs.kantarainitiative.org/umawg/" class="external-link" rel="nofollow" style="color: rgb(90, 141, 147); ">http://docs.kantarainitiative.org/umawg/</a></tt>&nbsp;or&nbsp;<tt><a href="http://docs.kantarainitiative.org/uma/" class="external-link" rel="nofollow" style="color: rgb(90, 141, 147); ">http://docs.kantarainitiative.org/uma/</a></tt>.</p><p style="font-size: 10pt; line-height: 13pt; color: rgb(0, 0, 0); font-weight: normal; margin-top: 10px; margin-right: 0px; margin-bottom: 10px; margin-left: 0px; padding-top: 0px; padding-right: 0px; padding-bottom: 0px; padding-left: 0px; ">Within such an area, the Work Group has the opportunity to manage the namespace as it sees fit, for example, including version or date numbers or spec module names as URL path components.</p><p style="font-size: 10pt; line-height: 13pt; color: rgb(0, 0, 0); font-weight: normal; margin-top: 10px; margin-right: 0px; margin-bottom: 10px; margin-left: 0px; padding-top: 0px; padding-right: 0px; padding-bottom: 0px; padding-left: 0px; ">Technical Specifications that make use of such URLs&nbsp;<b>must</b>&nbsp;make clear that they considered temporary until such time as the specification is finalized in an SDO.</p><p style="font-size: 10pt; line-height: 13pt; color: rgb(0, 0, 0); font-weight: normal; margin-top: 10px; margin-right: 0px; margin-bottom: 10px; margin-left: 0px; padding-top: 0px; padding-right: 0px; padding-bottom: 0px; padding-left: 0px; ">Work Groups can choose to use some other system of labeling, such as URNs, or URLs in a non-Kantara-related domain (with permission of the domain owner), but if they want to use the&nbsp;<tt><a href="http://kantarainitiative.org">kantarainitiative.org</a></tt>&nbsp;domain, it must be as prescribed in this policy.</p><h3 style="line-height: normal; font-weight: bold; padding-top: 0px; padding-right: 0px; padding-bottom: 0px; padding-left: 0px; font-size: 15pt; margin-top: 28px; margin-right: 0px; margin-bottom: 4px; margin-left: 0px; color: rgb(90, 141, 147); "><a name="TemporaryURLLabelinginTechnicalSpecifications-References"></a>References</h3><p style="font-size: 10pt; line-height: 13pt; color: rgb(0, 0, 0); font-weight: normal; margin-top: 10px; margin-right: 0px; margin-bottom: 10px; margin-left: 0px; padding-top: 0px; padding-right: 0px; padding-bottom: 0px; padding-left: 0px; ">For somewhat similar policies, see:</p><ul style="font-size: 10pt; line-height: 13pt; list-style-type: disc; "><li style="font-size: 10pt; line-height: 13pt; margin-top: 0px; margin-right: 0px; margin-bottom: 0px; margin-left: 0px; padding-top: 0px; padding-right: 0px; padding-bottom: 0px; padding-left: 0px; ">The&nbsp;<a href="http://docs.oasis-open.org/specGuidelines/ndr/namingDirectives.html" class="external-link" rel="nofollow" style="color: rgb(90, 141, 147); ">OASIS naming directives</a></li><li style="font-size: 10pt; line-height: 13pt; margin-top: 0px; margin-right: 0px; margin-bottom: 0px; margin-left: 0px; padding-top: 0px; padding-right: 0px; padding-bottom: 0px; padding-left: 0px; ">The&nbsp;<a href="http://www.w3.org/2005/07/13-nsuri" class="external-link" rel="nofollow" style="color: rgb(90, 141, 147); ">URIs for W3C Namespaces</a>&nbsp;policy</li></ul></span><div><br></div><div apple-content-edited="true"><br>Eve Maler &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;<a href="http://www.xmlgrrl.com/blog">http://www.xmlgrrl.com/blog</a><br>+1 425 345 6756 &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; <a href="http://www.twitter.com/xmlgrrl">http://www.twitter.com/xmlgrrl</a><br></div><br></div></div></body></html>