Proofread and extended
[privoxy.git] / doc / source / contacting.sgml
index 28b53ee..6982e89 100644 (file)
@@ -3,7 +3,7 @@
 
  Purpose     :  Entity included in other project documents.
                 
- $Id: contacting.sgml,v 1.12 2002/04/27 15:34:27 swa Exp $
+ $Id: contacting.sgml,v 1.13 2002/05/10 01:48:19 hal9 Exp $
 
  Copyright (C) 2001, 2002 Privoxy Developers <developers@privoxy.org>
  See LICENSE.
 <!-- Careful of the literallayout tags and finished formatting -->
 
 <para>
- We value your feedback. However, to provide you with the best support, please
- note the following sections.
+ We value your feedback. In fact, we rely on it to improve
+ <application>Privoxy</application> and its configuration.
+ However, please note the following hints, so we can 
+ provide you with the best support:
 </para>
 
 <sect2 id="contact-support"><title>Get Support</title>
-  <para>
-   <literallayout class="normal">
-To get support, use the Sourceforge Support Forum:
+<para>
+ For casual users, our support forum at
+ <ulink url="http://sourceforge.net/">SourceForge</ulink>
+ is probably best suited:
+ <ulink url="http://sourceforge.net/tracker/?group_id=11118&#38;atid=211118">http://sourceforge.net/tracker/?group_id=11118&#38;atid=211118</ulink>
+</para>
 
-    <ulink url="http://sourceforge.net/tracker/?group_id=11118&#38;atid=211118">http://sourceforge.net/tracker/?group_id=11118&#38;atid=211118</ulink>
-</literallayout>
-  </para>
-</sect2>
+<para>
+ All users are of course welcome to discuss their issues on the <ulink
+ url="http://lists.sourceforge.net/lists/listinfo/ijbswa-users">users
+ mailing list</ulink>, where the developers also hang around.
+</para>
 
-<sect2 id="contact-bugs"><title>Report bugs</title>
-  <para>
-   <literallayout class="normal">
-To submit bugs, use the Sourceforge Bug Forum:
-
-    <ulink url="http://sourceforge.net/tracker/?group_id=11118&#38;atid=111118">http://sourceforge.net/tracker/?group_id=11118&#38;atid=111118</ulink>. 
-</literallayout>
- </para>
-  <para>
-   Make sure that the bug has not already been submitted.  Please try to
-   verify that it is a <application>Privoxy</application> bug, and not a
-   browser or site bug first. If you are using your own custom configuration,
-   please try the stock configs to see if the problem is a configuration
-   related bug.  And if not using the latest development snapshot, please try
-   the latest one. Or even better, CVS sources. Please be sure to include the
-   <application>Privoxy</application> version, platform, browser, any
-   pertinent log data, any other relevant details (please be specific) and,
-   if possible, some way to reproduce the bug.
-  </para>
 </sect2>
 
-<sect2 id="contact-feature"><title>Request new features</title>
-  <para>
-   <literallayout class="normal">
-To submit ideas on new features, use the Sourceforge feature request forum:
+<sect2 id="contact-bugs"><title>Report Bugs</title>
+<para>
+ Please report all bugs <emphasis>only</emphasis> through our
+ bug tracker: 
+ <ulink url="http://sourceforge.net/tracker/?group_id=11118&#38;atid=111118">http://sourceforge.net/tracker/?group_id=11118&#38;atid=111118</ulink>. 
+</para>
+
+<para>
+  Before doing so, please make sure that the bug has not already been submitted
+  and observe the aditional hints at the top of the <ulink
+  url="http://sourceforge.net/tracker/?func=add&amp;group_id=11118&amp;atid=111118">submit
+  form</ulink>.
+</para>
+
+<para> 
+  Please try to verify that it is a <application>Privoxy</application> bug,
+  and not a browser or site bug first. If unsure,
+  try <ulink url="javascript:void(window.open('http://config.privoxy.org/toggle?mini=y&amp;set=disabled','ijbstatus','width=250,height=100,resizable=yes,scrollbars=no,toolbar=no,location=no,directories=no,status=no,menubar=no,copyhistory=no').focus());">toggling
+  off</ulink> <application>Privoxy</application>, and see if the problem persists.
+  The <link linkend="actionsanat">appendix</link> also has helpful information 
+  on action debugging. If you are using your own custom configuration, please try
+  the stock configs to see if the problem is configuration related.
+</para>
 
-    <ulink url="http://sourceforge.net/tracker/?atid=361118&#38;group_id=11118&#38;func=browse"></ulink>.
-</literallayout>
-  </para>
+<para>
+  If not using the latest version, chances are that the bug has been found
+  and fixed in the meantime. We would appreciate if you could take the time
+  to <link linkend="installation">upgrade to the latest version</link> (or
+  even the latest CVS snapshot) and verify your bug, but this is not required
+  for reporting.
+</para>
 </sect2>
 
-<sect2 id="contact-ads"><title>Report ads or other filter problems</title>
-  <para>
-<!--     <literallayout class="normal"> -->
-You can also send feedback on websites that Privoxy has problems with. Please bookmark
-the following link: <ulink url="javascript:w=Math.floor(screen.width/2);h=Math.floor(screen.height*0.9);void(window.open('http://www.privoxy.org/actions','Feedback','screenx='+w+',width='+w+',height='+h+',scrollbars=yes,toolbar=no,location=no,directories=no,status=no,menubar=no,copyhistory=no').focus());"><quote>Privoxy - Submit Filter Feedback</quote></ulink>. Once you surf to a page with problems, use the
-bookmark to send us feedback. We will look into the issue as soon as possible.
-<!--     </literallayout> -->
-  </para>
+<sect2 id="contact-feature"><title>Request New Features</title>
+<para>
+ You are welcome to submit ideas on new features or other proposals
+ for improvement through our feature request tracker at
+ <ulink url="http://sourceforge.net/tracker/?atid=361118&#38;group_id=11118">http://sourceforge.net/tracker/?atid=361118&#38;group_id=11118</ulink>.
+</para>
+</sect2>
+
+<sect2 id="contact-ads"><title>Report Ads or Other Actions-Related Problems</title>
+<para>
+ Please send feedback on ads that slipped through, innocent images that were blocked,
+ and any other problems relating to the <filename>default.action</filename> file through
+ our actions feedback mechanism located at
+ <ulink url="javascript:w=Math.floor(screen.width/2);h=Math.floor(screen.height*0.9);void(window.open('http://www.privoxy.org/actions','Feedback','screenx='+w+',width='+w+',height='+h+',scrollbars=yes,toolbar=no,location=no,directories=no,status=no,menubar=no,copyhistory=no').focus());">http://www.privoxy.org/actions/</ulink>.
+ On this page, you will also find a bookmark which will take you back there from
+ any troubled site and even pre-fill the form!
+</para> 
+
 <para>
  New, improved <filename>default.action</filename> files will occasionally be made
  available based on your feedback. These will be announced on the <ulink
  url="http://lists.sourceforge.net/lists/listinfo/ijbswa-announce">ijbswa-announce</ulink>
- list.
+ list and available from our <ulink url="http://sf.net/projects/ijbswa/">project page</ulink>.
 </para>
 </sect2>
 
 <sect2 id="contact-other"><title>Other</title>
- <para>
-   <literallayout class="normal">
-For any other issues, feel free to use the mailing lists:
-    <ulink url="http://sourceforge.net/mail/?group_id=11118">http://sourceforge.net/mail/?group_id=11118</ulink>.
-</literallayout>
- </para>
- <para>
-  Anyone interested in actively participating in development and related
-  discussions can also join the appropriate mailing list. Archives are
-  available, too. See the page on Sourceforge.
- </para>
+<para>
+For any other issues, feel free to use the mailing lists. Technically interested users
+and people who wish to contribute to the project are also welcome on the developers list!
+You can find an overview of all <application>Prixoxy</application>-related mailing lists,
+including list archives, at:
+<ulink url="http://sourceforge.net/mail/?group_id=11118">http://sourceforge.net/mail/?group_id=11118</ulink>.
+</para>
 </sect2>