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