W3C

List of comments on “Widgets 1.0: Widget URIs” (dated 8 October 2009)

Quick access to

There are 10 comments (sorted by their types, and the section they are about).

typo comments

Comment LC-2301
Commenter:
Context: in
Resolution status:

1) ** WELL DEFINED QUERY AND AUTHORITY **
http://www.w3.org/TR/webarch/#URI-scheme points to RFC 2617, which has been
replaced by RFC 4395. I think WebArch should be updated to recommend that
W3C recommendations must use "permanent" schemes and not "provisional" ones.

RFC 4395 requires that permanent scheme definitions be "Well-defined". Leaving in syntactic components and declaring them "out of scope" is leaving them undefined.

Suggestion: Remove 'authority' from the syntax, and any sections that
refer to them; disallow query components
Alternate Suggestion: define the meaning of "authority" and query components.
(space separated ids)
(Please make sure the resolution is adapted for public consumption)

substantive comments

Comment LC-2310
Commenter: Larry Masinter <masinter@adobe.com> (archived message)
Context: in
Not assigned
Resolution status:

9) ** ORIGIN CALCULATION **

A: "Usage as Origin"
This information applies to the notion of origin calculation which is itself incomplete, and introduces an unnecessary normative dependency.

Suggestion: Drop this section (if needed for widgets, put it somewhere
else)
(space separated ids)
(Please make sure the resolution is adapted for public consumption)

Comment LC-2302
Commenter: Larry Masinter <masinter@adobe.com> (archived message)
Context: in
Not assigned
Resolution status:

1) ** WELL DEFINED QUERY AND AUTHORITY **
http://www.w3.org/TR/webarch/#URI-scheme points to RFC 2617, which has been
replaced by RFC 4395. I think WebArch should be updated to recommend that
W3C recommendations must use "permanent" schemes and not "provisional" ones.

RFC 4395 requires that permanent scheme definitions be "Well-defined". Leaving in syntactic components and declaring them "out of scope" is leaving them undefined.

Suggestion: Remove 'authority' from the syntax, and any sections that
refer to them; disallow query components
Alternate Suggestion: define the meaning of "authority" and query components.
(space separated ids)
(Please make sure the resolution is adapted for public consumption)

Comment LC-2303
Commenter: Larry Masinter <masinter@adobe.com> (archived message)
Context: in
2) ** WELL-DEFINED MAPPING TO FILES **

Section 4.4 Step 2 makes normative reference:

http://www.w3.org/TR/widgets/#rule-for-finding-a-file-within-a-widget-

The algorithm there seems to be lacking a clear definition of "matches"
which deals reasonably with the issues surrounding matching and equivalence
for Unicode strings, or the handling of character sets in IRIs which are
not represented in UTF8.

Suggestion (Editorial): Move the definition of the mapping algorithm
into the URI scheme registration document so that its definition can
be reviewed for completeness.
Suggestion (Technical): Define exactly and precisely what "match" means
and make it clear what the appropriate response or error conditions are
if there is more than one file that "match"es.
(space separated ids)
(Please make sure the resolution is adapted for public consumption)

Comment LC-2304
Commenter: Larry Masinter <masinter@adobe.com> (archived message)
Context: in
Not assigned
Resolution status:

3) ** Reuse URI schemes **

http://www.w3.org/TR/webarch/#URI-scheme includes "Good practice: Reuse URI schemes"

"A specification SHOULD reuse an existing URI scheme (rather than create a new one) when it provides the desired properties of identifiers and their relation to resources."

The draft suggests there are many other schemes (with merit) already proposed, but that these existing efforts, "rather than identify packaged resources from the outside, widget URIs identify them only on the inside of a package, irrespective of that package's own location.", but this seems to indicate that the requirements for "widget" URIs are weaker, not stronger.

Suggestion: Supply use cases where reuse of existing schemes (including "thismessage:/") do not provide the desired properties of identifiers and their relation to resources.
Alternate Suggestion: Withdraw registration of "widget:" and reference existing scheme.
Alternate Suggestion: Provide guidelines so that "widget:" can be used for other applications
that need a way of referencing components within ZIP packages; rename "widget:" to use
a scheme name that is appropriate for this broader application.

AWWW Suggestion: add guideline: "Make New URI Schemes Reusable If You Can't Reuse URI schemes".
(space separated ids)
(Please make sure the resolution is adapted for public consumption)

editorial comments

Comment LC-2306
Commenter: Larry Masinter <masinter@adobe.com> (archived message)
Context: in
Not assigned
Resolution status:

5) ** EDITORIAL USE OF URI FOR IRI **

"Throughout this specification, wherever the term URI [URI] is used, it can be replaced interchangeably with the term IRI [RFC3987]. All widget URIs are IRIs, but the term URI is more common and was therefore preferred for readability."

Seriously, do we need a W3C Guideline or Finding to cover "DO NOT REDEFINE TERMS"?
There's glory for you! (see http://www.sabian.org/Alice/lgchap06.htm ).

Suggestion: Use "IRI" since that's what is meant.
(space separated ids)
(Please make sure the resolution is adapted for public consumption)

Comment LC-2307
Commenter: Larry Masinter <masinter@adobe.com> (archived message)
Context: in
Not assigned
Resolution status:

6) ** EDITORIAL RE FRAGMENT **

"Note that assigning semantics or interpretation to the query or fragment components is outside the scope of this specification. The ways in which they are used depends on the content types that they are applied to, or what executable script decides to do with them."

The wording might be taken to mean that a URI scheme registration normally *does* assign semantics or interpretation to the fragment components.

Suggestion: drop this note.
(space separated ids)
(Please make sure the resolution is adapted for public consumption)

Comment LC-2308
Commenter: Larry Masinter <masinter@adobe.com> (archived message)
Context: in
Not assigned
Resolution status:

7) ** EDITORIAL TITLE **
"Widgets 1.0: Widget URIs" the "1.0" might imply some kind of versioning, but there is no versioning of URI schemes.

Suggestion: retitle "Widget URIs"
(space separated ids)
(Please make sure the resolution is adapted for public consumption)

Comment LC-2309
Commenter: Larry Masinter <masinter@adobe.com> (archived message)
Context: in
Not assigned
Resolution status:

8) ** EDITORIAL DOCUMENT ORGANIZATION **

Are "A, B, C and D" appendices? Normative?
Suggestion: remove A ("Usage as Origin") either remove B ("Requirements") or edit it to be comprehensible to someone not familiar with the widgets specification, make C ("Acknowledgements") and D ("References") into normal document sections.
(space separated ids)
(Please make sure the resolution is adapted for public consumption)

Comment LC-2305
Commenter: Larry Masinter <masinter@adobe.com> (archived message)
Context: A. Usage as Origin In some contexts one needs to map a URI...
Not assigned
Resolution status:

4) ** EDITORIAL RE OTHER SCHEME **

"In fact, it is possible that both this scheme and another defined to access Zip archive content would be used jointly, with little or no overlap in functionality."

Without any other context, this is incomprehensible.

Suggestion: remove sentence.
(space separated ids)
(Please make sure the resolution is adapted for public consumption)

Add a comment.


Developed and maintained by Dominique Hazaël-Massieux (dom@w3.org).
$Id: Overview.php,v 1.46 2013-10-04 08:11:33 dom Exp $
Please send bug reports and request for enhancements to w3t-sys.org