Proofread and extended
[privoxy.git] / doc / source / contacting.sgml
1 <!--
2  File        :  $Source: /cvsroot/ijbswa/current/doc/source/contacting.sgml,v $
3
4  Purpose     :  Entity included in other project documents.
5                 
6  $Id: contacting.sgml,v 1.13 2002/05/10 01:48:19 hal9 Exp $
7
8  Copyright (C) 2001, 2002 Privoxy Developers <developers@privoxy.org>
9  See LICENSE.
10
11  ======================================================================
12   This file used for inclusion with other documents only.
13  ======================================================================
14
15  This file is included into:
16
17   faq
18   developer-manual
19   README
20   user-manual
21   webserver/index.sgml
22
23 -->
24
25 <!-- READ: -->
26 <!-- Careful of the literallayout tags and finished formatting -->
27
28 <para>
29  We value your feedback. In fact, we rely on it to improve
30  <application>Privoxy</application> and its configuration.
31  However, please note the following hints, so we can 
32  provide you with the best support:
33 </para>
34
35 <sect2 id="contact-support"><title>Get Support</title>
36 <para>
37  For casual users, our support forum at
38  <ulink url="http://sourceforge.net/">SourceForge</ulink>
39  is probably best suited:
40  <ulink url="http://sourceforge.net/tracker/?group_id=11118&#38;atid=211118">http://sourceforge.net/tracker/?group_id=11118&#38;atid=211118</ulink>
41 </para>
42
43 <para>
44  All users are of course welcome to discuss their issues on the <ulink
45  url="http://lists.sourceforge.net/lists/listinfo/ijbswa-users">users
46  mailing list</ulink>, where the developers also hang around.
47 </para>
48
49 </sect2>
50
51 <sect2 id="contact-bugs"><title>Report Bugs</title>
52 <para>
53  Please report all bugs <emphasis>only</emphasis> through our
54  bug tracker: 
55  <ulink url="http://sourceforge.net/tracker/?group_id=11118&#38;atid=111118">http://sourceforge.net/tracker/?group_id=11118&#38;atid=111118</ulink>. 
56 </para>
57
58 <para>
59   Before doing so, please make sure that the bug has not already been submitted
60   and observe the aditional hints at the top of the <ulink
61   url="http://sourceforge.net/tracker/?func=add&amp;group_id=11118&amp;atid=111118">submit
62   form</ulink>.
63 </para>
64
65 <para> 
66   Please try to verify that it is a <application>Privoxy</application> bug,
67   and not a browser or site bug first. If unsure,
68   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
69   off</ulink> <application>Privoxy</application>, and see if the problem persists.
70   The <link linkend="actionsanat">appendix</link> also has helpful information 
71   on action debugging. If you are using your own custom configuration, please try
72   the stock configs to see if the problem is configuration related.
73 </para>
74
75 <para>
76   If not using the latest version, chances are that the bug has been found
77   and fixed in the meantime. We would appreciate if you could take the time
78   to <link linkend="installation">upgrade to the latest version</link> (or
79   even the latest CVS snapshot) and verify your bug, but this is not required
80   for reporting.
81 </para>
82 </sect2>
83
84 <sect2 id="contact-feature"><title>Request New Features</title>
85 <para>
86  You are welcome to submit ideas on new features or other proposals
87  for improvement through our feature request tracker at
88  <ulink url="http://sourceforge.net/tracker/?atid=361118&#38;group_id=11118">http://sourceforge.net/tracker/?atid=361118&#38;group_id=11118</ulink>.
89 </para>
90 </sect2>
91
92 <sect2 id="contact-ads"><title>Report Ads or Other Actions-Related Problems</title>
93 <para>
94  Please send feedback on ads that slipped through, innocent images that were blocked,
95  and any other problems relating to the <filename>default.action</filename> file through
96  our actions feedback mechanism located at
97  <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>.
98  On this page, you will also find a bookmark which will take you back there from
99  any troubled site and even pre-fill the form!
100 </para> 
101
102 <para>
103  New, improved <filename>default.action</filename> files will occasionally be made
104  available based on your feedback. These will be announced on the <ulink
105  url="http://lists.sourceforge.net/lists/listinfo/ijbswa-announce">ijbswa-announce</ulink>
106  list and available from our <ulink url="http://sf.net/projects/ijbswa/">project page</ulink>.
107 </para>
108 </sect2>
109
110 <sect2 id="contact-other"><title>Other</title>
111 <para>
112 For any other issues, feel free to use the mailing lists. Technically interested users
113 and people who wish to contribute to the project are also welcome on the developers list!
114 You can find an overview of all <application>Prixoxy</application>-related mailing lists,
115 including list archives, at:
116 <ulink url="http://sourceforge.net/mail/?group_id=11118">http://sourceforge.net/mail/?group_id=11118</ulink>.
117 </para>
118 </sect2>