validator/htdocs feedback.html,1.21,1.22

Update of /sources/public/validator/htdocs
In directory hutz:/tmp/cvs-serv14882

Modified Files:
	feedback.html 
Log Message:
copying latest feedback page for potential static usage

Index: feedback.html
===================================================================
RCS file: /sources/public/validator/htdocs/feedback.html,v
retrieving revision 1.21
retrieving revision 1.22
diff -u -d -r1.21 -r1.22
--- feedback.html	6 Sep 2004 19:40:26 -0000	1.21
+++ feedback.html	21 Jun 2005 05:55:37 -0000	1.22
@@ -3,16 +3,24 @@
 --><!--#set var="title" value="How To Provide Feedback for The W3C Markup Validation Service"
 --><!--#set var="relroot" value="./"
 --><!--#include virtual="header.html" -->
-<div class="doc"><a id="skip" name="skip"></a>
-<h2>How to Provide Feedback<br />
-For the W3C Markup Validator</h2>
+<div class="doc">
+<h2>How to Provide Feedback For the W3C Markup Validator</h2>
 
-<dl>
-  <dt>If your page doesn't validate, and you don't know why, or
-      you have a question about
-      <acronym title="HyperText Markup Language">HTML</acronym>
-      or validation:</dt>
-  <dd>
+<div id="toc">
+<p>There are many ways to send feedback or discuss the Markup Validator:</p>
+<ol>
+  <li>If you need <a href="#needhelp">help on validation or Web authoring</a></li>
+
+  <li>If you would like to <a href="#errormsg">send a suggestion on a validation error message</a></li>
+  <li>If you want to <a href="#mailinglist">help, participate or discuss</a></li>
+  <li>If you want to <a href="#bugreport">search or report bugs</a>.</li>
+</ol>
+</div>
+
+<h3 id="needhelp"><a name="skip" id="skip"></a>Finding help on validation and Web Authoring</h3>
+    <p>Your page doesn't validate, and you don't know why, or
+    you have a question about <acronym title="HyperText Markup Language">HTML</acronym>, 
+    stylesheets or validation?</p>
     <p>
       <strong>First, check our <a href="docs/help.html">Help and <acronym title="Frequently Asked Questions">FAQ</acronym> document</a>, as well as the
       <a href="http://www.htmlhelp.com/faq/">Web authoring <acronym title="Frequently Asked Questions">FAQ</acronym></a>
@@ -20,21 +28,13 @@
     </p>
     <p>
       The two most common problems are:
+      <a href="http://www.htmlhelp.com/tools/validator/problems.html#amp">Validating pages with 
+      ampersands (&amp;'s) in
+      <acronym title="Uniform Resource Locators">URLs</acronym></a> and
+      <a href="http://www.htmlhelp.com/tools/validator/problems.html#script">Validating pages with 
+      JavaScript: <acronym title="HyperText Markup Language">HTML</acronym>
+        in a <code>SCRIPT</code> Element</a>.
     </p>
-    <ul>
-      <li>Validating pages with &amp;'s in <acronym
-      	title="Universal Resource Locators">URLs</acronym>:
-      see <a
-      href="http://www.htmlhelp.com/tools/validator/problems.html#amp">Ampersands
-      (&amp;'s) in <acronym
-      	title="Universal Resource Identifiers">URLs</acronym></a></li>
-      <li>Validating pages with JavaScript:
-	      see <a
-        href="http://www.htmlhelp.com/tools/validator/problems.html#script">Writing
-        <acronym title="HyperText Markup Language">HTML</acronym>
-        in a <code>SCRIPT</code> Element</a></li>
-    </ul>
-
   <p>
     If your problem isn't covered by one of the resources above,
     you can send it to one of the following forums:
@@ -56,46 +56,105 @@
 		<acronym title="Universal Resource Locator">URL</acronym>
 		when you ask your question!
   </p>
-  </dd>
 
-  <dt>If you are interested in helping to improve this
-    service, by writing code or just providing ideas:</dt>
 
-  <dd>
+<h3 id="errormsg">Error Message feedback</h3>
+      <p>If you think the error messages in the Markup Validator's result pages could be improved, or are not comprehensible, 
+      you can send questions and suggestions to our mailing-list.</p>
+
+      
+
+    <p>Before you send any feedback on error messages, we encourage you to search the archives for existing messages on this error 
+      in case your feedback has already been sent, or answers to 
+      your query have already been given. </p>
+
+  
+
+      <form method="get" action="http://www.w3.org/Search/Mail/Public/search">
+      <p>Search the archives of the www-validator mailing-list:<br />
+        <input id="type-index" name="type-index" type="hidden" value="www-validator" />
+        <input id="index-type" name="index-type" type="hidden" value="t" />
+  
+        <input name="keywords" type="text" size="33" maxlength="100" value="" />
+  
+        <input type="submit" name="search" value="Search Mail Archives" />
+      </p>
+      </form>
+
+  <p>Once you have checked that your suggestion has not been given yet, you can send your message. To write an efficient message:</p>
+  <ul>
+    <li><strong>Add a meaningful subject</strong>: summarize your feedback in a handful of words;</li>
+    <li>If our system added [VE][XX] at the beginning of the mail subject, keep it. 
+    Otherwise, please precise which error message you are sending feedback about;</li>
+    <li><strong>Give a URL</strong> whenever possible: If your feedback comes from your experience validating a page, knowing what page it was will help us diagnose issues much quicker. 
+     </li>
+    <li>Explain your suggestion, or question, in a clear and informative manner.</li>
+  </ul>
+    
+  <p>Once you have checked all the criteria above, 
+    <a href="mailto:www-validator@w3.org?Subject=%20Error%20Message%20Feedback&amp;body=Validating%20%0D%0A%0D%0A[%20Add%20your%20message/question%20here.%0D%0A%20%20Follow%20the%20instructions%20at%0D%0Ahttp%3A%2F%2Fvalidator.w3.org%2Ffeedback.html%23errormsg%20]">send your message to the www-validator public mailing-list</a>.
+   </p>
+   
+<h3 id="mailinglist">Discuss and participate</h3>
+
+<p>If you are interested in helping to improve this
+    service, by writing code or just providing ideas, you should feel fee to join or send a message to our mailing-list.</p>
+
     <p>
-      Please join and contribute to the <a
-      href="http://lists.w3.org/Archives/Public/www-validator/"><code>www-validator</code> mailing list</a>.
+      The <strong>public</strong> mailing-list to discuss the Markup Validator, Link checker and other tools is 
+      <a href="http://lists.w3.org/Archives/Public/www-validator/"><code>www-validator</code></a>.
+    </p>
+
+    <p>You can <a title="Send a message to the www-validator-request subscription handler"
+    href="mailto:www-validator@w3.org?Subject=subscribe">subscribe</a> to the list
+    (and <a title="Send a message to the www-validator-request subscription handler"
+     href="mailto:www-validator@w3.org?Subject=unsubscribe">unsubscribe</a>), or if 
+     you just have a small patch or idea and don't want to join the list, feel
+     free to <a title="Send a message to the www-validator mailing list"
+     href="mailto:www-validator@w3.org">send it directly to the list</a>. But whatever you do, 
+     <strong>always use the <a href="http://www.w3.org/Search/Mail/Public/search?index-type=t;type-index=www-validator">mail
+     search engine</a></strong> first to check for existing messages on a given topic.
     </p>
 
     <p>
-      If you just have a small patch or idea and don't want to join the list, feel
-      free to <a title="Send a message to the www-validator mailing list"
-      href="mailto:www-validator@w3.org">send it directly to the list</a>.
+      If you just want to have an informal discussion with developers and users of the Validator, 
+      you may also join the IRC channel #validator on the 
+      <a href="http://freenode.net/using_the_network.shtml">freenode</a> network (irc.freenode.net).
+      However, please keep in mind that <em>this is not a support channel</em>.
     </p>
-  </dd>
-  <dt>If you want to report a bug or log a feature request:</dt>
-  <dd>
+
+<h3 id="bugreport">Bug reports</h3>
     <p>
       The W3C maintains a public bug tracking database known as <a
         href="http://www.w3.org/Bugs/Public/">Bugzilla</a> where developers
       and other technical users can log bug reports and feature suggestions
       directly. If you are not familiar with issue tracking systems in general
-      or the Bugzilla bug tracker, send your feedback to the mailing list
+      or the Bugzilla bug tracker, send your feedback to the <a href="#mailinglist">mailing list</a>
       and someone on the W3C Validator Team will take care of logging your
       issue as appropriate.
     </p>
 
+    <p>Before you enter a new bug in this database, we strongly encourage you to check that it is not yet in the list of opened issues. Here are a few links that you can use:</p>
+
     <ul>
       <li><a href="http://www.w3.org/Bugs/">W3C issue tracking system homepage</a></li>
-      <li><a href="http://www.w3.org/Bugs/Public/buglist.cgi?product=Validator&amp;bug_status=NEW&amp;bug_status=ASSIGNED&amp;bug_status=REOPENED">All active Markup Validator issues</a></li>
-      <li><a href="http://www.w3.org/Bugs/Public/buglist.cgi?product=Validator">All Markup Validator issues</a></li>
+      <li><a href="http://www.w3.org/Bugs/Public/buglist.cgi?product=Validator;bug_status=NEW;bug_status=ASSIGNED;bug_status=REOPENED;order=bugs.bug_id">All open Markup Validator issues</a></li>
+      <li><a href="http://www.w3.org/Bugs/Public/buglist.cgi?product=Validator;order=bugs.bug_id">All Markup Validator issues</a></li>
       <li><a href="http://www.w3.org/Bugs/Public/query.cgi?product=Validator">Search Markup Validator issues</a></li>
       <li><a href="http://www.w3.org/Bugs/Public/enter_bug.cgi?product=Validator">New Markup Validator issue</a></li>
     </ul>
-  </dd>
-</dl>
+
+      <form method="get" action="http://www.w3.org/Bugs/Public/buglist.cgi">
+      <p>You may also search the bug database directly:<br />
+      <input name="short_desc_type" type="hidden" value="allwordssubstr" />
+      <input name="product" type="hidden" value="Validator" />
+      <input name="short_desc" type="text" size="40" maxlength="100" value="" />
+      <input type="submit" name="search" value="Search Bug database" />
+      </p>      
+</form>
+
 </div>
 <!--#include virtual="footer.html" -->
-  </body>
+</body>
 </html>
 

Received on Tuesday, 21 June 2005 05:55:44 UTC