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

Thank you, Daniel.

Heads up to other TAG members:  I consider the attached suggestions to be 
good ones, and editorial in scope.  I therefore plan to incorporate either 
the suggested changes or something similar when SDW is published in a few 
days.  If you disagree or feel that this requires further review, please 
let me know ASAP.  Thank you.

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 Friday, 30 January 2009 22:35:44 UTC