This document:Public document·Annotated document·View comments·Search comments·Add a new comment·Send replies to comments·Disposition of Comments·
Nearby:Web Applications Working Group
Other specs in this tool
Quick access to LC-2301
There are 10 comments (sorted by their types, and the section they are about).
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.
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
2) ** WELL-DEFINED MAPPING TO FILES **
Section 4.4 Step 2 makes normative reference:
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.
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".
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.
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.
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.
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"
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.
Add a comment.