W3C home > Mailing lists > Public > www-validator-cvs@w3.org > August 2010

link-checker commit: softening wording in error/info message

From: Mercurial notifier <nobody@w3.org>
Date: Thu, 05 Aug 2010 14:47:16 +0000
To: link-checker updates <www-validator-cvs@w3.org>
Message-Id: <E1Oh1j2-00067L-Oc@blinky.w3.org>
changeset:   258:5156ae48a49c
user:        ot
date:        Tue Jan 06 20:12:55 2009 +0000
files:       bin/checklink
description:
softening wording in error/info message


diff -r c641ac5ce943 -r 5156ae48a49c bin/checklink
--- a/bin/checklink	Sun Jan 04 17:52:20 2009 +0000
+++ b/bin/checklink	Tue Jan 06 20:12:55 2009 +0000
@@ -5,7 +5,7 @@
 # (c) 1999-2009 World Wide Web Consortium
 # based on Renaud Bruyeron's checklink.pl
 #
-# $Id: checklink,v 4.126 2009-01-04 17:52:20 ville Exp $
+# $Id: checklink,v 4.127 2009-01-06 20:12:55 ot Exp $
 #
 # This program is licensed under the W3C(r) Software License:
 #       http://www.w3.org/Consortium/Legal/copyright-software
@@ -260,7 +260,7 @@
   $PROGRAM     = 'W3C-checklink';
   $VERSION     = '4.3';
   $REVISION    = sprintf('version %s (c) 1999-2009 W3C', $VERSION);
-  my ($cvsver) = q$Revision: 4.126 $ =~ /(\d+[\d\.]*\.\d+)/;
+  my ($cvsver) = q$Revision: 4.127 $ =~ /(\d+[\d\.]*\.\d+)/;
   $AGENT       = sprintf('%s/%s [%s] %s',
                          $PROGRAM, $VERSION, $cvsver,
                          (W3C::UserAgent::USE_ROBOT_UA
@@ -2060,7 +2060,7 @@
         $redirect_loop ? ' <em>redirect loop detected</em>' : '';
       printf("
 <dt%s>%s%s</dt>
-<dd>What to do: <em>%s</em>%s<br /></dd>
+<dd>What does this mean? How to Fix? : <em>%s</em>%s<br /></dd>
 <dd>Response status code: %s<br />
 Response message: %s%s%s</dd>
 <dd>Line%s: %s</dd>\n",
@@ -2154,18 +2154,18 @@
 {
   # Advices to fix the problems
 
-  my %todo = ( 200 => 'Some of the links to this resource point to broken URI fragments, which should be removed or fixed.',
-               300 => 'It usually means that there is a typo in a link that triggers mod_speling action - this must be fixed!',
-               301 => 'This is a permanent redirect. The link should be updated.',
+  my %todo = ( 200 => 'Some of the links to this resource point to broken URI fragments (such as index.html#fragment).',
+               300 => 'This often happens when a typo in the link gets corrected automatically by the server. For the sake of performance, the link should be fixed.',
+               301 => 'This is a permanent redirect. The link should be updated to point to the more recent URI.',
                302 => 'This is a temporary redirect. Update the link if you believe it makes sense, or leave it as is.',
-               303 => 'Usually nothing.',
+               303 => 'This rare status code points to a "See Other" resource. There is generally nothing to be done.',
                307 => 'This is a temporary redirect. Update the link if you believe it makes sense, or leave it as is.',
-               400 => 'Usually the sign of a malformed URL that cannot be parsed by the server.',
-               401 => "The link is not public. You'd better specify it.",
+               400 => 'This is usually the sign of a malformed URL that cannot be parsed by the server. Check the syntax of the link.',
+               401 => "The link is not public and the actual resource is only available behind authentication. If not already done, you could specify it.",
                403 => 'The link is forbidden! This needs fixing. Usual suspects: a missing index.html or Overview.html, or a missing ACL.',
-               404 => 'The link is broken. Fix it.',
-               405 => 'The server does not allow HEAD requests. Go ask the guys who run this server why. Check the link manually.',
-               406 => "The server isn't capable of responding according to the Accept* headers sent. Check it out.",
+               404 => 'The link is broken. Double-check that you have not made any typo, or mistake in copy-pasting. If the link points to a resource that no longer exists, you may want to remove or fix the link.',
+               405 => 'The server does not allow HTTP HEAD requests, which prevents the Link Checker to check the link automatically.  Check the link manually.',
+               406 => "The server isn't capable of responding according to the Accept* headers sent. This is likely to be a server-side issue with negotiation.",
                407 => 'The link is a proxy, but requires Authentication.',
                408 => 'The request timed out.',
                410 => 'The resource is gone. You should remove this link.',
Received on Thursday, 5 August 2010 14:47:33 UTC

This archive was generated by hypermail 2.3.1 : Wednesday, 7 January 2015 15:17:44 UTC