Errata in Architecture of the World Wide Web

W3C > TAG

Errata in “Architecture of the World Wide Web”

The latest version of Architecture of the World Wide Web, Volume One:
http://www.w3.org/TR/webarch/
Please email error reports to:
public-webarch-comments@w3.org (public archive)

About “Architecture of the World Wide Web, Volume One”

“Architecture of the World Wide Web, Volume One” was developed by W3C's Technical Architecture Group (TAG). The W3C Recommendation describes the properties we desire of the Web and the design choices that have been made to achieve them. It is intended to inform discussions about issues of Web architecture.

This document lists the known errata to in Architecture of the World Wide Web, Volume One. Each entry has the following information:

References to the errata sheet should refer to it as of a specific date and include the number of the most recent error recorded.

Please email error reports to public-webarch-comments@w3.org (public archive).

Entries

Interpretation of prose in 3.3; raised by Chris Lilley
Added: 13 Sep 2005
Type: Clarification
Refers to: Section 3.3 of Volume 1 (First Edition)
Problem:

“I am concerned that this could be interpreted in an entirely different way to the sense that was mean while this section was being discussed.”

Correction:

In section 3.3, replace the second paragraph:

On the other hand, there is no inconsistency in serving HTML content with the media type "text/plain", for example, as this combination is licensed by specifications.

With:

On the other hand, there is no inconsistency in serving HTML content with the media type "text/plain", for example, as this combination is licensed by specifications and results in the plain text source of the HTML file being displayed. Silently “correcting” the text/plain to text/html and displaying the HTML as normal would not, however, be licensed by specifications.

URI and IRI references; raised by Roy Fielding
Added: 13 Sep 2005
Type: Clarification
Refers to: References of Volume 1 (First Edition)
Problem:

“For the sake of formality, please update the webarch references [to URI and IRI] as part of the erratum process.”

Correction:

Update the References to point to IETF STD 66, RFC 3986 and IETF RFC 3987 as suggested.

Typo in Status; raised by Martin Duerst
Added: 13 Sep 2005
Type: Minor
Refers to: Status of Volume 1 (First Edition)
Problem:

“…history of changes so this…” should be “…history of changes to this…”

Correction:

Make the suggested change.

Typo in Status; raised by Richard Tobin
Added: 13 Sep 2005
Type: Minor
Refers to: Status of Volume 1 (First Edition)
Problem:

The URI that purports to point to the archive of www-tag actually points to the archive of public-webarch-comments.

Correction:

Change the indicated URI to: http://lists.w3.org/Archives/Public/www-tag/

Missing anchor; raised by Norman Walsh
Added: 13 Sep 2005
Type: Minor
Refers to: Section 1 of Volume 1 (First Edition)
Problem:

The figure in Section 1 is valuable, but there's no way to refer to it.

Correction:

Replace the markup for that figure:

<div class="figure">
<p><a name="p21" id="p21"></a><img src="uri-res-rep.png"
alt="A resource (Oaxaca Weather Info) is identified by a
particular URI and is represented by pseudo-HTML content" /></p>
</div>

With:

<div class="figure">
<p><a name="fig-uri-res-rep"></a><a name="p21" id="p21"><img
src="http://www.w3.org/TR/webarch/uri-res-rep.png"
alt="A resource (Oaxaca Weather Info) is
identified by a particular URI and is represented
by pseudo-HTML content"/></p>
<div class="figure-title">Figure 1: The relationship between identifier,
resource, and representation</div>
</div>

And add the following rule to the document's CSS:

div.figure-title { font-weight: bold; }
Version identification “good practice” questioned:
Added: 12 July 2007
Type: Substantive
Refers to: Section 4.2.1 of Volume 1 (First Edition)
Problem:

In the course of ongoing discussion about versioning, the TAG has come to question whether its good practice that a “…data format specification SHOULD provide for version information” is, in fact, good practice. It is no longer clearly a point about which the TAG has consensus.

Correction:

Unresolved


This document last modified: $Date: 2007/07/12 16:34:17 $ by $Author: NormanWalsh $