## Please edit system and help pages ONLY in the moinmaster wiki! For more
## information, please see MoinMaster:MoinPagesEditorGroup.
##master-page:FrontPage
#format wiki
#language en
#pragma section-numbers off

= Welcome to the HttpComponents Wiki =

This wiki provides additional documentation for HttpClient and !HttpComponents.  Formal documentation is available from the [[http://hc.apache.org/|HttpComponents website]].  Users are encouraged to contribute information to this wiki that may be useful to others.  Please note that as an anti-spam measure, you must be logged in to edit pages.  You can use [UserPreferences] to create an account or login.

The HttpComponents wiki is a part of the big [[http://wiki.apache.org/|Apache Wiki Farm]].
If you're new to wikis, you might want to read HelpForBeginners to get an idea of how they work and how you can contribute.


== User Information ==

User information is meant for people using our components or Commons !HttpClient 3.1,
or for people considering to use them.
For starters, we have a list of HttpClientPowered applications that use !HttpClient.
Then there is documentation and several FAQs in this list:

   1. [[QuickStart|QuickStart]]
   1. [[GuidedTourOfHttpCore|Guided Tour of HttpCore]] - Overview documentation for !HttpComponents Core
   1. [[FrequentlyAskedApplicationDesignQuestions|Application Design FAQ]]
   1. [[FrequentlyAskedConnectionManagementQuestions|Connection Management FAQ]] - What is TIME_WAIT etc
   1. [[LessonsLearned|Lessons Learned from 100+ websites]] - Common website practices

We also keep a [[http://hc.apache.org/user-docs.html|user documentation index]] on our website.
It points to !JavaDocs and example code not linked from this wiki.

If you are considering the old codebase versus the new components, the
[[HttpClient3vsHttpClient4vsHttpCore|benchmark results]]
could be of use.
<<BR>>
If you are stuck with a very old JVM and have to use HTTPS, you need a
[[AlternativeJSSE|JSSE Implementation]].



== Developer Information ==

Developer information is meant for people working on our project codebase,
including the Java source code as well as the sources for generating our website.

The first set of links describes technical procedures:

   1. WebSite - How to update and deploy the !HttpComponents website
   1. [[HttpComponentsCoreReleaseProcess|HttpComponents Core release process]] - How to cut and publish a release of !HttpComponents Core
   1. [[CommonsHttpClientReleaseProcess|Commons HttpClient 3.x release process]] - How to cut and publish a release of Commons !HttpClient 3.x

Then we have some non-procedural information for reference:

   1.#4 JavaDocGuidelines - API !JavaDoc guidelines for !HttpComponents
   1. ReferenceMaterials - Links to relevant standards

== PMC Information ==

   1. [[BoardReports|Board Reports]]
   1. [[BoardResolutions|Board Resolutions]]