You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@hc.apache.org by ol...@apache.org on 2025/02/16 10:25:36 UTC

(httpcomponents-website) 01/01: Updated project website for HttpClient 5.5-alpha1 release

This is an automated email from the ASF dual-hosted git repository.

olegk pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/httpcomponents-website.git

commit 923b588bc07ea2cd6e3631588dada4c68491168d
Author: Oleg Kalnichevski <ol...@apache.org>
AuthorDate: Sun Feb 16 11:15:28 2025 +0100

    Updated project website for HttpClient 5.5-alpha1 release
---
 .../httpcomponents-client-5.4.x/examples-async.md  |  28 ++--
 .../examples-reactive.md                           |   2 +-
 .../httpcomponents-client-5.4.x/examples.md        |  40 ++---
 .../httpcomponents-client-5.5.x/download.md        |  39 +++++
 .../examples-async.md                              |   0
 .../examples-reactive.md                           |   0
 .../examples.md                                    |   5 +
 .../markdown/httpcomponents-client-5.5.x/index.md  |  90 +++++++++++
 .../httpcomponents-client-5.5.x/quickstart.md      | 178 +++++++++++++++++++++
 src/site/markdown/news.md                          |  24 +++
 .../documentation.links                            |   5 +
 src/site/site.xml                                  |  10 ++
 12 files changed, 386 insertions(+), 35 deletions(-)

diff --git a/src/site/markdown/httpcomponents-client-5.4.x/examples-async.md b/src/site/markdown/httpcomponents-client-5.4.x/examples-async.md
index 0f560da..a09caab 100644
--- a/src/site/markdown/httpcomponents-client-5.4.x/examples-async.md
+++ b/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.
\ No newline at end of file
diff --git a/src/site/markdown/httpcomponents-client-5.4.x/examples-reactive.md b/src/site/markdown/httpcomponents-client-5.4.x/examples-reactive.md
index d251a8a..2aab8bd 100644
--- a/src/site/markdown/httpcomponents-client-5.4.x/examples-reactive.md
+++ b/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.
diff --git a/src/site/markdown/httpcomponents-client-5.4.x/examples.md b/src/site/markdown/httpcomponents-client-5.4.x/examples.md
index 7849469..d095090 100644
--- a/src/site/markdown/httpcomponents-client-5.4.x/examples.md
+++ b/src/site/markdown/httpcomponents-client-5.4.x/examples.md
@@ -20,7 +20,7 @@
 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
@@ -28,87 +28,87 @@ HttpClient Examples (Classic)
   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.
\ No newline at end of file
diff --git a/src/site/markdown/httpcomponents-client-5.5.x/download.md b/src/site/markdown/httpcomponents-client-5.5.x/download.md
new file mode 100644
index 0000000..c98d157
--- /dev/null
+++ b/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)
diff --git a/src/site/markdown/httpcomponents-client-5.4.x/examples-async.md b/src/site/markdown/httpcomponents-client-5.5.x/examples-async.md
similarity index 100%
copy from src/site/markdown/httpcomponents-client-5.4.x/examples-async.md
copy to src/site/markdown/httpcomponents-client-5.5.x/examples-async.md
diff --git a/src/site/markdown/httpcomponents-client-5.4.x/examples-reactive.md b/src/site/markdown/httpcomponents-client-5.5.x/examples-reactive.md
similarity index 100%
copy from src/site/markdown/httpcomponents-client-5.4.x/examples-reactive.md
copy to src/site/markdown/httpcomponents-client-5.5.x/examples-reactive.md
diff --git a/src/site/markdown/httpcomponents-client-5.4.x/examples.md b/src/site/markdown/httpcomponents-client-5.5.x/examples.md
similarity index 94%
copy from src/site/markdown/httpcomponents-client-5.4.x/examples.md
copy to src/site/markdown/httpcomponents-client-5.5.x/examples.md
index 7849469..4371344 100644
--- a/src/site/markdown/httpcomponents-client-5.4.x/examples.md
+++ b/src/site/markdown/httpcomponents-client-5.5.x/examples.md
@@ -43,6 +43,11 @@ HttpClient Examples (Classic)
   This example demonstrates how to insert custom request interceptor and an execution interceptor to the request
   execution chain.
 
+- [Classic APIs over async HttpClient](https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientClassicOverAsync.java)
+
+  This example demonstrates create a classic HttpClient adaptor over an async HttpClient providing compatibility
+  with the classic APIs based on the InputStream / OutputStream model.
+
 - [Abort method](https://github.com/apache/httpcomponents-client/tree/master/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.
diff --git a/src/site/markdown/httpcomponents-client-5.5.x/index.md b/src/site/markdown/httpcomponents-client-5.5.x/index.md
new file mode 100644
index 0000000..e6b9d61
--- /dev/null
+++ b/src/site/markdown/httpcomponents-client-5.5.x/index.md
@@ -0,0 +1,90 @@
+<!--
+    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 Overview
+===================
+
+The Hyper-Text Transfer Protocol (HTTP) is perhaps the most significant protocol used on the Internet today. Web
+services, network-enabled appliances and the growth of network computing continue to expand the role of the HTTP
+protocol beyond user-driven web browsers, while increasing the number of applications that require HTTP support.
+
+Although the java.net package provides basic functionality for accessing resources via HTTP, it doesn't provide the full
+flexibility or functionality needed by many applications. HttpClient seeks to fill this void by providing an efficient,
+up-to-date, and feature-rich package implementing the client side of the most recent HTTP standards and recommendations.
+
+Designed for extension while providing robust support for the base HTTP protocol, HttpClient may be of interest to
+anyone building HTTP-aware client applications such as web browsers, web service clients, or systems that leverage or
+extend the HTTP protocol for distributed communication.
+
+Documentation
+-------------
+
+1. [Quick Start](quickstart.md) - contains simple, complete examples of request execution with the classic, fluent and
+   async APIs.
+1. Examples demonstrating some common as well as more complex use cases
+
+    * [HttpClient (classic APIs)](examples.md)
+    * [HttpClient (async APIs)](examples-async.md)
+    * [HttpClient (reactive APIs)](examples-reactive.md)
+
+1. Javadocs
+
+    * [HttpClient](./current/httpclient5/apidocs/)
+    * [HC Fluent](./current/httpclient5-fluent/apidocs/)
+    * [HttpClient Cache](./current/httpclient5-cache/apidocs/)
+    * [HttpClient Windows extensions](./current/httpclient5-win/apidocs/)
+
+1. API compatibility reports
+
+    * [HttpClient](./current/httpclient5/japicmp.html)
+    * [HC Fluent](./current/httpclient5-fluent/japicmp.html)
+    * [HttpClient Cache](./current/httpclient5-cache/japicmp.html)
+    * [HttpClient Windows extensions](./current/httpclient5-win/japicmp.html)
+
+Features
+--------
+
+- Standards based, pure Java, implementation of HTTP versions 1.0, 1.1, 2.0
+- Supports encryption with HTTPS (HTTP over SSL) protocol.
+- Pluggable TLS strategies.
+- Transparent message exchanges through HTTP/1.1, HTTP/1.0 and SOCKS proxies.
+- Tunneled HTTPS connections through HTTP/1.1 and HTTP/1.0 proxies, via the CONNECT method.
+- Basic, Digest, Bearer authentication schemes.
+- HTTP state management and cookie support.
+- Flexible connection management and pooling.
+- Support for HTTP response caching.
+- Source code is freely available under the Apache License.
+
+Standards Compliance
+--------------------
+
+HttpClient strives to conform to the following specifications endorsed by the Internet Engineering Task Force (IETF) and
+the internet at large:
+
+- [RFC 9110](https://datatracker.ietf.org/doc/html/rfc9110) - HTTP Semantics
+- [RFC 9111](https://datatracker.ietf.org/doc/html/rfc9111) - HTTP Caching
+- [RFC 9112](https://datatracker.ietf.org/doc/html/rfc9112) - Hypertext Transfer Protocol Version 1.1 (HTTP/1.1)
+- [RFC 7540](https://datatracker.ietf.org/doc/html/rfc7540) - Hypertext Transfer Protocol Version 2 (HTTP/2)
+- [RFC 7541](https://datatracker.ietf.org/doc/html/rfc7541) - HPACK: Header Compression for HTTP/2
+- [RFC 1945](https://datatracker.ietf.org/doc/html/rfc1945) - Hypertext Transfer Protocol -- HTTP/1.0
+- [RFC 2396](https://datatracker.ietf.org/doc/html/rfc2396) - Uniform Resource Identifiers (URI): Generic Syntax
+- [RFC 6265](https://datatracker.ietf.org/doc/html/rfc6265) - HTTP State Management Mechanism (Cookies)
+- [RFC 7616](https://datatracker.ietf.org/doc/html/rfc7616) - HTTP Digest Access Authentication
+- [RFC 7617](https://datatracker.ietf.org/doc/html/rfc7617) - HTTP 'Basic' Authentication Scheme
+- [RFC 5861](https://datatracker.ietf.org/doc/html/rfc5861) - HTTP Cache-Control Extensions for Stale Content
diff --git a/src/site/markdown/httpcomponents-client-5.5.x/quickstart.md b/src/site/markdown/httpcomponents-client-5.5.x/quickstart.md
new file mode 100644
index 0000000..d32caca
--- /dev/null
+++ b/src/site/markdown/httpcomponents-client-5.5.x/quickstart.md
@@ -0,0 +1,178 @@
+<!--
+    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 Quick Start
+======================
+
+- Download 'Binary' package of the latest HttpClient 5.5 release or configure dependency on `HttpClient` and `Fluent HC`
+  modules using a dependency manager of your choice as described [here](./download.md).
+
+- HttpClient 5.5 requires Java 1.8 or newer.
+
+- The below code fragment illustrates the execution of HTTP GET and POST requests using the HttpClient native API.
+
+    ```
+    try (CloseableHttpClient httpclient = HttpClients.createDefault()) {
+        ClassicHttpRequest httpGet = ClassicRequestBuilder.get("http://httpbin.org/get")
+                .build();
+        // The underlying HTTP connection is still held by the response object
+        // to allow the response content to be streamed directly from the network socket.
+        // In order to ensure correct deallocation of system resources
+        // the user MUST call CloseableHttpResponse#close() from a finally clause.
+        // Please note that if response content is not fully consumed the underlying
+        // connection cannot be safely re-used and will be shut down and discarded
+        // by the connection manager.
+        httpclient.execute(httpGet, response -> {
+            System.out.println(response.getCode() + " " + response.getReasonPhrase());
+            final HttpEntity entity1 = response.getEntity();
+            // do something useful with the response body
+            // and ensure it is fully consumed
+            EntityUtils.consume(entity1);
+            return null;
+        });
+
+        ClassicHttpRequest httpPost = ClassicRequestBuilder.post("http://httpbin.org/post")
+                .setEntity(new UrlEncodedFormEntity(Arrays.asList(
+                        new BasicNameValuePair("username", "vip"),
+                        new BasicNameValuePair("password", "secret"))))
+                .build();
+        httpclient.execute(httpPost, response -> {
+            System.out.println(response.getCode() + " " + response.getReasonPhrase());
+            final HttpEntity entity2 = response.getEntity();
+            // do something useful with the response body
+            // and ensure it is fully consumed
+            EntityUtils.consume(entity2);
+            return null;
+        });
+    }
+    ```
+
+- The same requests can be executed using a simpler, albeit less flexible, fluent API.
+
+    ```
+    // The fluent API relieves the user from having to deal with manual deallocation of system
+    // resources at the cost of having to buffer response content in memory in some cases.
+    
+    Request.Get("http://targethost/homepage")
+        .execute().returnContent();
+    Request.Post("http://targethost/login")
+        .bodyForm(Form.form().add("username",  "vip").add("password",  "secret").build())
+        .execute().returnContent();
+    ```
+
+- The below code fragment illustrates the execution of HTTP requests using HttpClient async API.
+
+    ```
+    try (CloseableHttpAsyncClient httpclient = HttpAsyncClients.createDefault()) {
+        // Start the client
+        httpclient.start();
+    
+        // Execute request
+        SimpleHttpRequest request1 = SimpleRequestBuilder.get("http://httpbin.org/get").build();
+        Future<SimpleHttpResponse> future = httpclient.execute(request1, null);
+        // and wait until response is received
+        SimpleHttpResponse response1 = future.get();
+        System.out.println(request1.getRequestUri() + "->" + response1.getCode());
+    
+        // One most likely would want to use a callback for operation result
+        CountDownLatch latch1 = new CountDownLatch(1);
+        SimpleHttpRequest request2 = SimpleRequestBuilder.get("http://httpbin.org/get").build();
+        httpclient.execute(request2, new FutureCallback<SimpleHttpResponse>() {
+    
+            @Override
+            public void completed(SimpleHttpResponse response2) {
+                latch1.countDown();
+                System.out.println(request2.getRequestUri() + "->" + response2.getCode());
+            }
+    
+            @Override
+            public void failed(Exception ex) {
+                latch1.countDown();
+                System.out.println(request2.getRequestUri() + "->" + ex);
+            }
+    
+            @Override
+            public void cancelled() {
+                latch1.countDown();
+                System.out.println(request2.getRequestUri() + " cancelled");
+            }
+    
+        });
+        latch1.await();
+    
+        // In real world one most likely would want also want to stream
+        // request and response body content
+        CountDownLatch latch2 = new CountDownLatch(1);
+        AsyncRequestProducer producer3 = AsyncRequestBuilder.get("http://httpbin.org/get").build();
+        AbstractCharResponseConsumer<HttpResponse> consumer3 = new AbstractCharResponseConsumer<HttpResponse>() {
+    
+            HttpResponse response;
+    
+            @Override
+            protected void start(HttpResponse response, ContentType contentType) throws HttpException, IOException {
+                this.response = response;
+            }
+    
+            @Override
+            protected int capacityIncrement() {
+                return Integer.MAX_VALUE;
+            }
+    
+            @Override
+            protected void data(CharBuffer data, boolean endOfStream) throws IOException {
+                // Do something useful
+            }
+    
+            @Override
+            protected HttpResponse buildResult() throws IOException {
+                return response;
+            }
+    
+            @Override
+            public void releaseResources() {
+            }
+    
+        };
+        httpclient.execute(producer3, consumer3, new FutureCallback<HttpResponse>() {
+    
+            @Override
+            public void completed(HttpResponse response3) {
+                latch2.countDown();
+                System.out.println(request2.getRequestUri() + "->" + response3.getCode());
+            }
+    
+            @Override
+            public void failed(Exception ex) {
+                latch2.countDown();
+                System.out.println(request2.getRequestUri() + "->" + ex);
+            }
+    
+            @Override
+            public void cancelled() {
+                latch2.countDown();
+                System.out.println(request2.getRequestUri() + " cancelled");
+            }
+    
+        });
+        latch2.await();
+    
+    }
+    ```    
+
+
diff --git a/src/site/markdown/news.md b/src/site/markdown/news.md
index 78f91ef..443a606 100644
--- a/src/site/markdown/news.md
+++ b/src/site/markdown/news.md
@@ -20,6 +20,30 @@
 HttpComponents Project News
 ===========================
 
+###### 17 Feb 2025 - HttpComponents Client 5.5-alpha1 released
+
+This is the first ALPHA release in the 5.5 release series. It adds several experimental
+features and improvements such as request multiplexing over a shared HTTP/2 connection
+and the Classic API facade acting as a compatibility bridge between classic I/O client
+services and the asynchronous message transport used internally.
+
+Notable changes and features included in the 5.5 series:
+
+* Improved conformance to RFC 7616 (HTTP Digest Access Authentication).
+
+* The connection pool implementation acts as a caching facade in front of a standard
+  managed connection pool and shares already leased connections to multiplex message
+  exchanges over active HTTP/2 connections. Experimental.
+
+* Extended Auth API and improved authentication protocol logic to support mutual
+  authentication.
+
+* The Classic API facade acting as a compatibility bridge between the classic I/O client
+  services (based on the standard InputStream / OutputStream model) and the asynchronous
+  message transport used internally. Experimental.
+
+* HTTP/2 support for the Fluent Facade (via Classic API facade). Experimental.
+
 ###### 3 Feb 2025 - HttpComponents Client 5.4.2 GA released
 
 This is a maintenance release that upgrades HttpCore to version 5.3.3 and fixes several
diff --git a/src/site/resources/httpcomponents-client-5.5.x/documentation.links b/src/site/resources/httpcomponents-client-5.5.x/documentation.links
new file mode 100644
index 0000000..6b2fd41
--- /dev/null
+++ b/src/site/resources/httpcomponents-client-5.5.x/documentation.links
@@ -0,0 +1,5 @@
+# links property file for Ant's symlink task in pom.xml:
+# links to components in https://hc.apache.org/components/
+
+5.5-alpha1  ../components/httpcomponents-client-5.5.x/5.5-alpha1
+current     ../components/httpcomponents-client-5.5.x/5.5-alpha1
diff --git a/src/site/site.xml b/src/site/site.xml
index 22caf3b..3efde2e 100644
--- a/src/site/site.xml
+++ b/src/site/site.xml
@@ -72,6 +72,16 @@ under the License.
       <item name="Get Involved" href="get-involved.html"/>
     </menu>
     <menu name="Components">
+      <item name="HttpClient 5.5 ALPHA" collapse="true" href="httpcomponents-client-5.5.x/index.html">
+        <item name="Quick Start" href="httpcomponents-client-5.5.x/quickstart.html"/>
+        <item name="Examples (Classic)" href="httpcomponents-client-5.5.x/examples.html"/>
+        <item name="Examples (Async)" href="httpcomponents-client-5.5.x/examples-async.html"/>
+        <item name="Examples (Reactive)" href="httpcomponents-client-5.5.x/examples-reactive.html"/>
+        <item name="Logging Guide" href="httpcomponents-client-5.4.x/logging.html"/>
+        <item name="Android" href="httpcomponents-client-5.4.x/android.html"/>
+        <item name="Related" href="httpcomponents-client-5.4.x/related-projects.html"/>
+        <item name="Download" href="httpcomponents-client-5.5.x/download.html"/>
+      </item>
       <item name="HttpClient 5.4" collapse="true" href="httpcomponents-client-5.4.x/index.html">
         <item name="Quick Start" href="httpcomponents-client-5.4.x/quickstart.html"/>
         <item name="Migration Guide" collapse="true" href="httpcomponents-client-5.4.x/migration-guide/index.html">