A mailing list is an electronic discussion forum that you can subscribe to. Once you are subscribed, you will receive every email that is sent to the list, and you can send mails to the list yourself. Every mail you send there will be received by hundreds, maybe thousands of subscribers. It will also become available in public archives indefinitely.
Please note that usage of these mailing lists is subject to the Public Forum Archive Policy
Please take a few minutes to read this page, in order to avoid annoyance for other subscribers, and embarrassment for yourself. There is a common set of etiquette guidelines for internet forums, sometimes called netiquette. You should be aware of these and try to observe them, here as well as in other forums.
Eric S. Raymond and Rick Moen have written an article called "How To Ask Questions The Smart Way" about mailing list netiquette. It's a long read, but worth the effort.
Note: Please do NOT send your HttpComponents questions to the two authors. They welcome feedback on the article itself, but are simply not a help resource for HttpComponents.
Before you post a question to a mailing list, make sure it isn't already answered. Read the available documentation. Search the web, and in particular the mailing list archives. Being answered with a link to a mail or FAQ entry that addresses exactly your question is one of the embarrassments you should avoid.
If you are answered with a link to a mail, don't take it too hard either. Maybe you didn't know the correct terms to search for, or the mail was sent on another list. People that follow a mailing list for a long time are bound to remember some of the old mails, and it may be easier for them to locate the old mail than to write down the answer again.
Different kinds of questions are discussed in different forums. It is important to choose the right forum for your question. Posting a question to the wrong forum reduces your chances of getting a useful response. You will reach fewer people that can answer your question, and those that could will be less inclined to do so.
Do not cross-post. Do not send your question to more than one list. If you are in doubt where to post your question, it is better to pick the wrong list than to send it to several lists. Even if you get answers on more than one list, people subscribed to only one list will not be able to follow the whole discussion. Mailing list archives will also contain only fragments of the discussion, so that it becomes harder for others with the same question to find the answer.
The article mentioned above has a section called "Choose your forum carefully". It basically tells you the same stuff you'll find below.
If you develop an application that uses HttpClient, and you need advice on how to achieve something with it, post your question to the httpclient-users list. If you don't know whether HttpClient can do what you want it to do, post your question to the users list. Even though you are a developer, you are not a developer of the HttpComponents. So please don't post your question to the developer list.
And if somebody else asks a question you can answer, please do so!
If you want to discuss development of HttpComponents, post your question or suggestion to the dev list. The developer list is used to discuss architecture, API design, new features, and bugs. Bug reports and comments filed in JIRA will automatically be sent to this list, too.
We are using JIRA as our issue tracking system. Although this is not a mailing list, and should not be abused as a general discussion forum, it is another way to contact the HttpComponent developers. All issues and comments will be sent to the developer mailing list.
If you are absolutely sure that you have found a bug, you can open a new issue for it. Choose "Bug" as the issue type. If you are absolutely sure that our components don't provide a feature that would be useful for you and others, you can open a new issue for it. Choose "New Feature" or "Wish" for it.
If you are not absolutely sure, please ask on the appropriate mailing list first. Most developers are monitoring both lists, and we will tell you if you should open a new issue.
Never send a question directly to one of the people you have seen active on the mailing lists, or whose email address you've found in the source code. You will be scorned and rebuffed, or at best ignored.
HttpComponents, as any other Apache project, is a community. Questions asked on a mailing list can be answered by any member of the community who knows the answer and has the time to write it down. Answers sent to a mailing list are available to everyone, through the public mailing list archives. This benefits the whole community.
By sending a question directly to somebody, you are implying that this person alone is responsible for helping you out, and only you. No, we're not. We participate in a community. Post your question to the community at large, and chances are that one of the members will answer it. If that requires information that is of little interest to the community, for example large log files, you will be asked to send such information directly to the person that picked up your question.
It's OK to send a "Thank You" mail to a person that helped you. Just make sure that your next question goes to the mailing list again.
Some of the people reading your mail will be processing dozens or hundreds of mails daily. To get their attention and a quick reply, it is important that you make your mail easy to read and that you provide the background information that is needed to answer your question. The biggest part of the article on asking smart questions mentioned above addresses this problem, so we'll only give you the highlights here.
The HttpComponents project currently uses the following lists. Clicking on a list name will take you to a page with subscribe, unsubscribe, and archive information. See below for information on digests.
To subscribe to the list "xxx", send a mail to "firstname.lastname@example.org". While you are subscribed, you will receive all mails sent to the list. You can send mails to the list yourself using the address "email@example.com". This does not apply for the commits list, where only the source code repository is allowed to send mails.
To unsubscribe from the list "xxx", send a mail to "firstname.lastname@example.org". Unsubscribe information is also appended to every mail sent via the list.
The digest of a list collects all mails of that list, sending you occasional updates. Each update contains the subjects of the recent mails, and the mails themselves as attachments. This significantly reduces the number of individual mails you receive from the list, while still giving you access to all the information.
To subscribe to the digest of list "xxx", send a mail to "email@example.com". While you are subscribed to the digest, you can send mails to the list itself using the address "firstname.lastname@example.org". This does not apply for the commits list, where only the source code repository is allowed to send mails.
To unsubscribe from the digest of list "xxx", send a mail to "email@example.com". Unsubscribe information is also appended to every mail sent by the digest.