<TMPL_INCLUDE NAME="header.tmpl">

<div id="main">
<div class="doc"><a id="skip" name="skip"></a>
<h2>How to Provide Feedback For the W3C Markup Validator</h2>

<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">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>
      to see if your question has been answered there.</strong>
    </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>
  <p>
    If your problem isn't covered by one of the resources above,
    you can send it to one of the following forums:
  </p>

  <ul>
    <li>Usenet newsgroup: <code><a href="news:comp.infosystems.www.authoring.html">comp.infosystems.www.authoring.html</a></code></li>
    <li><a href="http://www.hwg.org/"><acronym
    	title="HyperText Markup Language">HTML</acronym> Writers Guild</a>
    	<a title="HTML Writers Guild Mailing Lists"
		    href="http://www.hwg.org/lists/">mailing lists</a></li>
  </ul>

  <p>
    Each of these forums have plenty of experienced <acronym
    	title="HyperText Markup Language">HTML</acronym>
		authors who are willing to share their expertise. If you are
		commenting on a specific page, be sure to provide a
		<acronym title="Universal Resource Locator">URL</acronym>
		when you ask your question!
  </p>


<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>

  <TMPL_IF NAME="errmsg_id">
    <p>Judging from the link you followed, you probably want to send feedback on error message [<TMPL_VAR NAME="errmsg_id" ESCAPE="HTML">]: "<TMPL_VAR NAME="explanation" ESCAPE="HTML">".</p> 
  </TMPL_IF>    

    <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>

  <TMPL_IF NAME="errmsg_id">
     <p>Below is a pre-filled search box that you can use. Or you can just <a href="http://www.w3.org/Search/Mail/Public/search?type-index=www-validator&amp;index-type=t&amp;keywords=%5BVE%5D%5B<TMPL_VAR NAME="errmsg_id" ESCAPE="URL">%5D&amp;search=Search">follow this link</a>.</p>
  </TMPL_IF>

      <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" />
  <TMPL_IF NAME="errmsg_id">
        <input name="keywords" type="text" size="33" maxlength="100" value="[VE][<TMPL_VAR NAME="errmsg_id" ESCAPE="URL">]" />
  <TMPL_ELSE>
        <input name="keywords" type="text" size="33" maxlength="100" value="" />
  </TMPL_IF>
        <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. 
     <TMPL_IF NAME="uri">In your case, that URL should be: <em><TMPL_VAR NAME="uri" ESCAPE="HTML"></em></TMPL_IF></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=<TMPL_IF NAME="errmsg_id">[VE][<TMPL_VAR NAME="errmsg_id">]</TMPL_IF>%20Error%20Message%20Feedback&amp;body=Validating%20<TMPL_IF NAME="uri"><TMPL_VAR NAME="uri" ESCAPE="HTML">%0D%0A</TMPL_IF><TMPL_IF NAME="errmsg_id">Error%20[<TMPL_VAR NAME="errmsg_id" ESCAPE="HTML">]:%20%22<TMPL_VAR NAME="explanation" ESCAPE="HTML">%22</TMPL_IF>%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>
      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 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>

<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 <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;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>

      <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>



    </div><!-- end of "main" -->

<TMPL_INCLUDE NAME="footer.tmpl">
