The NGINX Community
[ 280 ]
IRC channel
The IRC channel #nginx at irc.freenode.net is a real-time resource for those
interested in getting to know the developers and having helpful responses to short
queries. Please do follow IRC etiquette though when visiting the channel. Larger
blocks of text such as configuration files or compilation output should go into a
Pastebin and only the URL copied into the channel. More details about the channel
can be found at http://wiki.nginx.org/IRC.
Web resources
The wiki at http://wiki.nginx.org has been a useful resource for a number of years.
Here you will find a complete directive reference, a module listing, and a number of
configuration examples. Keep in mind though, that this is a wiki, and the information
found on it is not guaranteed to be accurate, up-to-date, or to fit your needs exactly.
As we have seen throughout this book, it is always important to think about what you
want to accomplish before setting out to derive the solution.
NGINX, Inc. maintains the official reference documentation located at http://nginx.
org/en/docs/. There are some documents introducing NGINX, as well as How-to's
and pages describing each module and directive.
Writing a good bug report
When searching for help online, it is useful to be able to write a good bug report.
You will find that an answer is much more easily forthcoming if you can formulate
the problem in a clear, reproducible way. This section will help you do just that.
The most difficult part of a bug report is actually defining the problem itself. It will
help you to first think about what it is you are trying to accomplish. State your goal
in a clear, concise manner as follows:
I need all requests to subdomain.example.com to be served from server1.
Avoid writing reports in the following manner:
I'm getting requests served from the local filesystem instead of
proxying them to server1 when I call subdomain.example.com.
Do you see the difference between these two statements? In the first case, you can
clearly see that there is a specific goal in mind. The second case describes more the
result of the problem than the goal itself.