~ubuntu-branches/debian/sid/varnish/sid

« back to all changes in this revision

Viewing changes to doc/sphinx/installation/help.rst

  • Committer: Bazaar Package Importer
  • Author(s): Stig Sandbeck Mathisen
  • Date: 2011-03-21 10:16:07 UTC
  • mfrom: (24.1.2 experimental)
  • Revision ID: james.westby@ubuntu.com-20110321101607-528fzl583fqanas5
Tags: 2.1.5-2
ReleaseĀ forĀ unstable

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
%%%%%%%%%%%%%%%%%%
 
2
Getting hold of us
 
3
%%%%%%%%%%%%%%%%%%
 
4
 
 
5
Getting hold of the gang behind Varnish is pretty straight forward,
 
6
we try to help as much as time permits and have tried to streamline
 
7
this process as much as possible.
 
8
 
 
9
But before you grab hold of us, spend a moment composing your thoughts and
 
10
formulate your question, there is nothing as pointless as simply telling
 
11
us "Varnish does not work for me" with no further information to give
 
12
any clue to why.
 
13
 
 
14
And before you even do that, do a couple of searches to see if your
 
15
question is already answered, if it has been, you will get your answer
 
16
much faster that way.
 
17
 
 
18
IRC Channel
 
19
===========
 
20
 
 
21
The most immediate way to get hold of us, is to join our IRC channel:
 
22
 
 
23
        ``#varnish on server irc.linpro.no``
 
24
 
 
25
The main timezone of the channel is Europe+America.
 
26
 
 
27
If you can explain your problem in a few clear sentences, without too
 
28
much copy&paste, IRC is a good way to try to get help. If you do need
 
29
to paste log files, VCL and so on, please use a pastebin_.
 
30
 
 
31
If the channel is all quiet, try again some time later, we do have lives,
 
32
families and jobs to deal with also.
 
33
 
 
34
You are more than welcome to just hang out, and while we don't mind
 
35
the occational intrusion of the real world into the flow, keep
 
36
it mostly on topic, and dont paste random links unless they are
 
37
*really* spectacular and intelligent.
 
38
 
 
39
Mailing Lists
 
40
=============
 
41
 
 
42
Getting on or off our mailinglist happens through MailMan_.
 
43
 
 
44
If you are going to use Varnish, subscribing to our ``varnish-announce``
 
45
mailing list is probably a very good idea.  The typical pattern is that
 
46
people spend some time getting Varnish running, and then more or less
 
47
forget about it.   Therefore the announce list is a good way to be
 
48
reminded about new releases, bad bugs or security holes.
 
49
 
 
50
The ``varnish-misc`` mailing list is for general banter, questions,
 
51
suggestions, ideas and so on.  If you are new to Varnish it may pay
 
52
off to subscribe to -misc, simply to have an ear to the telegraph-pole
 
53
and learn some smart tricks.  This is a good place to ask for help
 
54
with more complex issues, that require quoting of files and long
 
55
explanations.
 
56
 
 
57
Make sure to pick a good subject line, and if the subject of the
 
58
thread changes, please change the subject to match, some of us deal
 
59
with hundreds of emails per day, after spam-filters, and we need all
 
60
the help we can get to pick the interesting ones.
 
61
 
 
62
The ``varnish-dev`` mailing list is used by the developers and is
 
63
usually quite focused on source-code and such.  Everybody on
 
64
the -dev list is also on -misc, so cross-posting only serves to annoy
 
65
those people.
 
66
 
 
67
Trouble Tickets
 
68
===============
 
69
 
 
70
Please do not open a trouble ticket, unless you have spotted an actual
 
71
bug in Varnish.  Ask on IRC first if you are in doubt.
 
72
 
 
73
The reason for this policy, is to avoid the bugs being drowned in a
 
74
pile of sensible suggestions for future enhancements and call for help
 
75
from people who forget to check back if they get it and so on.
 
76
 
 
77
We track suggestions and ideas in our `"Shopping-List" wiki page`_, and user
 
78
support via email and IRC.
 
79
 
 
80
Commercial Support
 
81
==================
 
82
 
 
83
The following companies offer commercial Varnish support, and are listed
 
84
here for your convenience.  If you want your company listed here, drop
 
85
an email to phk@FreeBSD.org.
 
86
 
 
87
        Varnish Software
 
88
        sales@varnish-software.com
 
89
 
 
90
 
 
91
.. _Mailman: http://lists.varnish-cache.org/mailman/listinfo
 
92
.. _pastebin: http://gist.github.com/
 
93
.. _"Shopping-List" wiki page: http://varnish-cache.org/wiki/PostTwoShoppingList