Re: editorial: unclear use/misuse of "link" (vs. "link to")

Daniel: thank for these comments.  I expect to have a final published 
version of SDW out within a few days.  I believe I have either adopted or 
made what I consider minor adaptations of all of your suggestions below, 
and have further checked every word containing the characters "link".  I 
hope you will find the results to be an improvement.   Thank you again for 
the useful suggestions.

Noah

--------------------------------------
Noah Mendelsohn 
IBM Corporation
One Rogers Street
Cambridge, MA 02142
1-617-693-4036
--------------------------------------








"Barclay, Daniel" <daniel@fgm.com>
Sent by: www-tag-request@w3.org
01/30/2009 01:32 PM
 
        To:     <www-tag@w3.org>
        cc:     (bcc: Noah Mendelsohn/Cambridge/IBM)
        Subject:        editorial: unclear use/misuse of "link" (vs. "link 
to")


Regarding the document "The Self-Describing Web" at
http://www.w3.org/2001/tag/doc/selfDescribingDocuments-2008-12-03 :

A few sentences are a bit confusing because they use just the verb "link"
when they should use "link to."

Section 4.2.1 says:

   ... the ATOM entry that links it.

That occurrences of "links it" should be "links to it" (otherwise the 
reader is
left wondering, "'the entry that links it' ... to what?").

Section 1 says:

   Machine-processable specifications for interpreting new formats should
   be provided on the Web, and linked from representations that use ...

That "linked from" should (probably) be "linked to from" (or some 
construction
with "to which" if you want).

Section 4.2.1 also says:

   ... relationship between the linked resource and ...

That "the linked resource" should _probably_ be "the linked-to resource" 
(or,
again, some construction with "to which").


There are several other uses of "link" that should be edited.  (The 
majority
of uses of "link" and "link to" seem to be correct.)


(When "link" is used transitively, the object of the verb is the things 
are
are linked together (not something that the _subject_ of the verb links to
(or "not something to which the subject of the verb links") ).)


Daniel
--
(Plain text sometimes corrupted to HTML "courtesy" of Microsoft Exchange.) 
[F]

Received on Saturday, 7 February 2009 01:12:58 UTC