Updated project website for HttpClient 5.5-alpha1 release

Author: ok2c

src/site/markdown/httpcomponents-client-5.4.x/examples-async.md

@@ -20,66 +20,66 @@
 HttpClient Examples (Async)
 ===========================
 
-- [Asynchronous HTTP exchange](https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/AsyncClientHttpExchange.java)
+- [Asynchronous HTTP exchange](https://github.com/apache/httpcomponents-client/tree/5.4.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/AsyncClientHttpExchange.java)
 
   This example demonstrates a basic asynchronous HTTP request / response exchange. Response content is buffered in
   memory for simplicity.
 
-- [Asynchronous HTTP exchange with content streaming](https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/AsyncClientHttpExchangeStreaming.java)
+- [Asynchronous HTTP exchange with content streaming](https://github.com/apache/httpcomponents-client/tree/5.4.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/AsyncClientHttpExchangeStreaming.java)
 
   This example demonstrates an asynchronous HTTP request / response exchange with a full content streaming.
 
-- [Pipelined HTTP/1.1 exchanges](https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/AsyncClientHttp1Pipelining.java)
+- [Pipelined HTTP/1.1 exchanges](https://github.com/apache/httpcomponents-client/tree/5.4.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/AsyncClientHttp1Pipelining.java)
 
   This example demonstrates a pipelined execution of multiple HTTP/1.1 request / response exchanges. Response content is
   buffered in memory for simplicity.
 
-- [Multiplexed HTTP/2 exchanges](https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/AsyncClientH2Multiplexing.java)
+- [Multiplexed HTTP/2 exchanges](https://github.com/apache/httpcomponents-client/tree/5.4.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/AsyncClientH2Multiplexing.java)
 
   This example demonstrates a multiplexed execution of multiple HTTP/2 request / response exchanges. Response content is
   buffered in memory for simplicity.
 
-- [Request execution interceptors](https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/AsyncClientInterceptors.java)
+- [Request execution interceptors](https://github.com/apache/httpcomponents-client/tree/5.4.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/AsyncClientInterceptors.java)
 
   This example demonstrates how to insert custom request interceptor and an execution interceptor to the request
   execution chain.
 
-- [Message trailers](https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/AsyncClientMessageTrailers.java)
+- [Message trailers](https://github.com/apache/httpcomponents-client/tree/5.4.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/AsyncClientMessageTrailers.java)
 
   This example demonstrates how to use a custom execution interceptor to add trailers to all outgoing request enclosing
   an entity..
 
-- [Multiplexed HTTP/2 exchanges](https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/AsyncClientHttp2ServerPush.java)
+- [Multiplexed HTTP/2 exchanges](https://github.com/apache/httpcomponents-client/tree/5.4.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/AsyncClientHttp2ServerPush.java)
 
 This example demonstrates handling of HTTP/2 message exchanges pushed by the server.
 
-- [Client authentication](https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/AsyncClientAuthentication.java)
+- [Client authentication](https://github.com/apache/httpcomponents-client/tree/5.4.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/AsyncClientAuthentication.java)
 
   This example demonstrates execution of an HTTP request against a target site that requires user authentication.
 
-- [Custom SSL context](https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/AsyncClientCustomSSL.java)
+- [Custom SSL context](https://github.com/apache/httpcomponents-client/tree/5.4.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/AsyncClientCustomSSL.java)
 
   This example demonstrates how to create secure connections with a custom SSL context.
 
-- [Connection / TLS configuation per route / host](https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/AsyncClientConnectionConfig.java)
+- [Connection / TLS configuation per route / host](https://github.com/apache/httpcomponents-client/tree/5.4.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/AsyncClientConnectionConfig.java)
 
   This example demonstrates how to use connection configuration on a per-route or a per-host basis.
 
-- [Connection eviction](https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/AsyncClientConnectionEviction.java)
+- [Connection eviction](https://github.com/apache/httpcomponents-client/tree/5.4.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/AsyncClientConnectionEviction.java)
 
   This example demonstrates how to evict expired and idle connections from the connection pool.
 
-- [Preemptive BASIC authentication](https://github.com/apache/httpcomponents-client/blob/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/AsyncPreemptiveBasicClientAuthentication.java)
+- [Preemptive BASIC authentication](https://github.com/apache/httpcomponents-client/blob/5.4.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/AsyncPreemptiveBasicClientAuthentication.java)
 
   This example shows how HttpClient can be customized to authenticate preemptively using BASIC scheme. Generally,
   preemptive authentication can be considered less secure than a response to an authentication challenge and therefore
   discouraged.
 
-- [HTTP version negotiation](https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/AsyncClientHttpVersionPolicy.java)
+- [HTTP version negotiation](https://github.com/apache/httpcomponents-client/tree/5.4.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/AsyncClientHttpVersionPolicy.java)
 
   This example demonstrates how to make HttpClient negotiate or force a particular version of HTTP protocol during 
   the TLS handshake. Please note that protocol version policy setting also applies to non-HTTPS connections.
 
-- [Virtual HTTPS / SNI](https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/AsyncClientSNI.java)
+- [Virtual HTTPS / SNI](https://github.com/apache/httpcomponents-client/tree/5.4.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/AsyncClientSNI.java)
 
   This example demonstrates how to use SNI to send requests to a virtual HTTPS endpoint using the async I/O.

src/site/markdown/httpcomponents-client-5.4.x/examples-reactive.md

@@ -20,6 +20,6 @@
 HttpClient Examples (Async)
 ===========================
 
-- [HTTP exchange with Reactive Streams](https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/AsyncClientHttpExchange.java)
+- [HTTP exchange with Reactive Streams](https://github.com/apache/httpcomponents-client/tree/5.4.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/AsyncClientHttpExchange.java)
 
   This example demonstrates a reactive, full-duplex HTTP/1.1 message exchange using RxJava.

src/site/markdown/httpcomponents-client-5.4.x/examples.md

@@ -20,95 +20,95 @@
 HttpClient Examples (Classic)
 =============================
 
-- [Response handling](https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientResponseProcessing.java)
+- [Response handling](https://github.com/apache/httpcomponents-client/tree/5.4.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientResponseProcessing.java)
 
   This example demonstrates how to process HTTP responses using a response handler. This is the recommended way of
   executing HTTP requests and processing HTTP responses. This approach enables the caller to concentrate on the process
   of digesting HTTP responses and to delegate the task of system resource deallocation to HttpClient. The use of an HTTP
   response handler guarantees that the underlying HTTP connection will be released back to the connection manager
   automatically in all cases.
 
-- [Manual connection release](https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientConnectionRelease.java)
+- [Manual connection release](https://github.com/apache/httpcomponents-client/tree/5.4.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientConnectionRelease.java)
 
   This example demonstrates how to ensure the release of the underlying HTTP connection back to the connection manager
   in case of a manual processing of HTTP responses.
 
-- [HttpClient configuration](https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientConfiguration.java)
+- [HttpClient configuration](https://github.com/apache/httpcomponents-client/tree/5.4.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientConfiguration.java)
 
   This example demonstrates how to customize and configure the most common aspects of HTTP request execution and
   connection management.
 
-- [Request execution interceptors](https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientInterceptors.java)
+- [Request execution interceptors](https://github.com/apache/httpcomponents-client/tree/5.4.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientInterceptors.java)
 
   This example demonstrates how to insert custom request interceptor and an execution interceptor to the request
   execution chain.
 
-- [Abort method](https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientAbortMethod.java)
+- [Abort method](https://github.com/apache/httpcomponents-client/tree/5.4.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientAbortMethod.java)
 
   This example demonstrates how to abort an HTTP request before its normal completion.
 
-- [Client authentication](https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientAuthentication.java)
+- [Client authentication](https://github.com/apache/httpcomponents-client/tree/5.4.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientAuthentication.java)
 
   This example uses HttpClient to execute an HTTP request against a target site that requires user authentication.
 
-- [Request via a proxy](https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientExecuteProxy.java)
+- [Request via a proxy](https://github.com/apache/httpcomponents-client/tree/5.4.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientExecuteProxy.java)
 
   This example demonstrates how to send an HTTP request via a proxy.
 
-- [Proxy authentication](https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientProxyAuthentication.java)
+- [Proxy authentication](https://github.com/apache/httpcomponents-client/tree/5.4.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientProxyAuthentication.java)
 
   A simple example showing execution of an HTTP request over a secure connection tunneled through an authenticating
   proxy.
 
-- [Chunk encoded POST](https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientChunkEncodedPost.java)
+- [Chunk encoded POST](https://github.com/apache/httpcomponents-client/tree/5.4.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientChunkEncodedPost.java)
 
   This example shows how to stream out a request entity using chunk encoding.
 
-- [Custom execution context](https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientCustomContext.java)
+- [Custom execution context](https://github.com/apache/httpcomponents-client/tree/5.4.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientCustomContext.java)
 
   This example demonstrates the use of a local HTTP context populated custom attributes.
 
-- [Form based logon](https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientFormLogin.java)
+- [Form based logon](https://github.com/apache/httpcomponents-client/tree/5.4.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientFormLogin.java)
 
   This example demonstrates how HttpClient can be used to perform form-based logon.
 
-- [Threaded request execution](https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientMultiThreadedExecution.java)
+- [Threaded request execution](https://github.com/apache/httpcomponents-client/tree/5.4.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientMultiThreadedExecution.java)
 
   An example that executes HTTP requests from multiple worker threads.
 
-- [Custom SSL context](https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientCustomSSL.java)
+- [Custom SSL context](https://github.com/apache/httpcomponents-client/tree/5.4.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientCustomSSL.java)
 
   This example demonstrates how to create secure connections with a custom SSL context.
 
-- [Connection / TLS configuation per route / host](https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientConnectionConfig.java)
+- [Connection / TLS configuation per route / host](https://github.com/apache/httpcomponents-client/tree/5.4.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientConnectionConfig.java)
 
   This example demonstrates how to use connection configuration on a per-route or a per-host basis.
 
-- [Preemptive BASIC authentication](https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientPreemptiveBasicAuthentication.java)
+- [Preemptive BASIC authentication](https://github.com/apache/httpcomponents-client/tree/5.4.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientPreemptiveBasicAuthentication.java)
 
   This example shows how HttpClient can be customized to authenticate preemptively using BASIC scheme. Generally,
   preemptive authentication can be considered less secure than a response to an authentication challenge and therefore
   discouraged.
 
-- [Preemptive DIGEST authentication](https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientPreemptiveDigestAuthentication.java)
+- [Preemptive DIGEST authentication](https://github.com/apache/httpcomponents-client/tree/5.4.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientPreemptiveDigestAuthentication.java)
 
   This example shows how HttpClient can be customized to authenticate preemptively using DIGEST scheme. Generally,
   preemptive authentication can be considered less secure than a response to an authentication challenge and therefore
   discouraged.
 
-- [Proxy tunnel](https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ProxyTunnelDemo.java)
+- [Proxy tunnel](https://github.com/apache/httpcomponents-client/tree/5.4.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ProxyTunnelDemo.java)
 
   This example shows how to use ProxyClient in order to establish a tunnel through an HTTP proxy for an arbitrary
   protocol.
 
-- [Multipart encoded request entity](https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientMultipartFormPost.java)
+- [Multipart encoded request entity](https://github.com/apache/httpcomponents-client/tree/5.4.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientMultipartFormPost.java)
 
   This example shows how to execute requests enclosing a multipart encoded entity. 
 
-- [Connection endpoint details](https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientRemoteEndpointDetails.java)
+- [Connection endpoint details](https://github.com/apache/httpcomponents-client/tree/5.4.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientRemoteEndpointDetails.java)
 
   This example demonstrates how to get details of the underlying connection endpoint.
 
-- [Virtual HTTPS / SNI](https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientSNI.java)
+- [Virtual HTTPS / SNI](https://github.com/apache/httpcomponents-client/tree/5.4.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientSNI.java)
 
   This example demonstrates how to use SNI to send requests to a virtual HTTPS endpoint using the classic I/O.

src/site/markdown/httpcomponents-client-5.5.x/download.md

@@ -0,0 +1,39 @@
+<!--
+    Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+    
+      http://www.apache.org/licenses/LICENSE-2.0
+    
+    Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+-->
+
+HttpClient Downloads
+====================
+
+The latest release available for download:
+
+[Release packages](https://hc.apache.org/downloads.cgi) -
+[Release Notes](https://www.apache.org/dist/httpcomponents/httpclient/RELEASE_NOTES-5.4.x.txt) -
+[License](https://www.apache.org/licenses/LICENSE-2.0.html)
+
+Dependency management
+---------------------
+
+If you are using a dependency manager for your project such as [Apache Maven](https://maven.apache.org),
+[Gradle](https://gradle.org/) or [Apache Ivy](https://ant.apache.org/projects/ivy.html), you can create a dependency on
+HttpClient modules by using this information:
+
+- [HttpClient](https://search.maven.org/artifact/org.apache.httpcomponents.client5/httpclient5)
+- [HttpClient Fluent](https://search.maven.org/artifact/org.apache.httpcomponents.client5/httpclient5-fluent)
+- [HttpClient Cache](https://search.maven.org/artifact/org.apache.httpcomponents.client5/httpclient5-cache)
+- [HttpClient Windows extensions](https://search.maven.org/artifact/org.apache.httpcomponents.client5/httpclient5-win)