W3C home > Mailing lists > Public > www-tag@w3.org > October 2003

Review of Oct 1 webarch

From: Tim Bray <tbray@textuality.com>
Date: Sat, 04 Oct 2003 17:46:20 -0700
Message-ID: <3F7F69DC.2030201@textuality.com>
To: WWW-Tag <www-tag@w3.org>

Abstract: s/an/a/

Lose comma after "resources"

s/a provide/provide/

lose "and reason about" I have no idea what that means

"Web architecture encompasses both the definition of the information 
space in terms of identification and representation of its contents, and 
the protocols that define..."

"desired properties: efficiency, scalability..."

s/information media/media/

"This document's structure reflects the three dimensions..."

----------------------------
Status of this doc

"Where current practice conflicts with it..."

s/resolve their differences/address these issues/

might want to note that at this point there are no patent disclosures.

------------------------------------

1.

"is an information space in which objects, referred to as resources.."

"to illustrate typical behavior"

"software acting in the context of this information space.  Agents 
include...

Can we come to consensus on the formatting or URIs, the quotes and 
monotype font look like dogshit in conjunction with each other

"to access weather information"

"Web agents exchange information via messages.  Protocols define..." the 
phrase about "these messages arise" is kind of contorted and doesn't help.

s/origin server/server/

3.Messages carry representations of resources.

s/everything//

XHTML representation data, which includes references to weather maps 
identified by URIs; the browser retreives and displays those maps.
---------------------

1.1

"gives guidance"

----------------------------

1.1.2

s/includes some references/includes references/

"This document strives for brevity and precision while including 
illustrative examples"

s/some theoretical/theoretical/

----------------------------

2.

"across communities motivates"

s/this represents a link/this constitutes a link/

Replace sentence beginning "A link defines..." with "Links play many 
roles and support many software behaviors."  For example, hypertext 
browsers automatically follow lins to images and render them in context, 
but follow links to other textual resourcs only on request, and replace 
the current display when doing so.

Do reasoning systems really focsu activity on namespace references?

s/named,shared, or linked to within/a part of/

Principle: Use URIs s/is intended/might reasonably be expected/

"An information resource is one that conveys information.." NO!  I think 
an information resource is one that is essentially "an online unit of 
information or service", i.e. not a car.

------------------------

2.1  Good Praactice.

This is hard to get right.  What we're really saying is "don't do random 
escaping or re-coding, just preserve the characters you were given." 
Maybe "strive to avoid variation" or some such?

s/two URIs that are not equivalent/two URIs that are not identical/

is "authority agent" a well understood term?

----------------------

2.2

s/; this is called URI opacity//

re the Editor's note: I am totally OK with using "Web agent" here.

s/that explains how to assign identifiers/that explains how identifiers 
are assigned/

--------------

2.3

do news: URIs only identify groups not messages?

I'd put the assertion beginning "Furthermore, designers should expect" 
in its own paragraph and lose the leading "Furthermore".  It's awfully 
important.

-------------------------------------------

2.4.1

3rd bullet point: "specifies the syntax and semantics of fragment 
identifiers"

Move the para beginning "The secondary resource" down one para, after 
the one beginning "Fragment identifier semantics.."  Then rewrite it to 
say "Existing URI schemes specifiy a variety of roles for fragment 
identifiers, including some portion of..."

---------------------------------

2.4.2

s/encode the same visual map/provide the same visual map encoded/

s/their fragment identifier semantics (which are undefined)/define no 
fragment identifier semantics/

--------------------------------------

2.5

s/specification of/specification governing/

------------------------------------

2.5.1

list item 1. s/, which//

We need to note that we're not suggesting that all these specs are 
consulted at run-time, rather each phase of the agent's actions is 
consistent with specs normative in that context.

-------------------------------------

2.6

s/persistence is always a matter/persistence is a matter/

Editor's note: I'm OK with the Moby Dick para.

----------------------------------

2.7 Access control

Should this move into the "Interaction" section?

"Nadia and Dirk"... ooh, sounds like hot stuff

---------------------------

2.8.2

s/to state - or at least claim - formally/to assert/

-------------------------------

2.8.4

what is this section talking about?  I have no idea?

--------------------------------

3.

In the <ol>, the second half of the 2nd <li> I think is important enough 
to be pulled out of the list and given its own paragraph near the top of 
this section.

s/This will include/This includes/

---------------------------

3.2

s/Thousands of independent/Large numbers of independent/

------------------------

3.2.1

The "don't guess metadata" principle needs an example

-----------------------

4.

s/have flourished/gorwn in number/

------------------------------

4.2

s/designers SHOULD/designers MUST/

Might be a good idea to say that HTTP code 404 is a good example of this.

-----------------------------------

4.3

s/are, in general, harmful/are in general harmful,/

------------------------------


4.4

s/ Textual formats are often/Textual formats are usually/

s/tools any more complex/tools more complex/

----------------------------

4.5

disagree with definition of "extensibility"

-------------------

4.9.2

I don't agree with the last para.  I don't think the #1 problem with 
namespaces is DTDs.  First, the DTD problem isn't that bad, and 
secondly, the problems with poor understanding of interaction modes is 
much worse.

------------------------

4.9.3

Principle on Qnames needs a little introductory text to set the stage.

-----------------------------

4.9.5

Replace entire first para with "If all that is known about a 
representation of the resource http://example.com/oaxaca is that it is 
encoded in XML, what is the correct interpretation of 
http://example.com/oaxaca.com#x23?

s/it's/its/

in <ol>, in item 3, s/and\/or/and/

-------------------------------------

4.9.6

Sentence beginning "since XML documents", rewrite to: "Since XML's 
syntax is deigned to make documents self-describin..."
Received on Sunday, 5 October 2003 10:45:45 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Thursday, 26 April 2012 12:47:21 GMT