Add more introduction text to help people get started

Hummingbird.docc/HummingbirdHTTP2/HummingbirdHTTP2.md

@@ -8,6 +8,14 @@ Add HTTP2 support to Hummingbird server.
 
 ## Overview
 
+HummingbirdHTTP2 is bundled with Hummingbird, but is not enabled by default. To enable HTTP2 support, you need to add the target dependency to your target:
+
+```sh
+swift package add-target-dependency HummingbirdHTTP2 <MyApp> --package hummingbird
+```
+
+Make sure to replace `<MyApp>` with the name of your App's target.
+
 HummingbirdHTTP2 provides HTTP2 upgrade support via ``HTTP2UpgradeChannel``. You can add this to your application using ``HummingbirdCore/HTTPServerBuilder/http2Upgrade(tlsConfiguration:additionalChannelHandlers:)``.
 
 ```swift

Hummingbird.docc/HummingbirdTLS/HummingbirdTLS.md

@@ -8,7 +8,15 @@ Add TLS support to Hummingbird server.
 
 ## Overview
 
-HummingbirdTLS provides TLS support via ``TLSChannel``. You can add this to your application using ``HummingbirdCore/HTTPServerBuilder/tls(_:tlsConfiguration:)``.
+HummingbirdTLS is bundled with Hummingbird, but is not enabled by default. To enable TLS support, you need to add the target dependency to your target:
+
+```sh
+swift package add-target-dependency HummingbirdTLS <MyApp> --package hummingbird
+```
+
+Make sure to replace `<MyApp>` with the name of your App's target.
+
+HummingbirdTLS provides TLS protocol support via ``TLSChannel``. You can add this to your application using ``HummingbirdCore/HTTPServerBuilder/tls(_:tlsConfiguration:)``.
 
 ```swift
 // Load certificates and private key to construct server TLS configuration
@@ -26,7 +34,7 @@ let app = Application(
 )
 ```
 
-The function `tls` can be used to wrap any other child channel in the example above we use it to wrap an HTTP1 channel.
+The function `tls` can be used to wrap another protocol. In the example above we use it to wrap HTTP1 server, and you can also wrap a WebSocket Supporting HTTP/1 server.
 
 ## Topics
 
@@ -41,3 +49,4 @@ The function `tls` can be used to wrap any other child channel in the example ab
 - ``Hummingbird``
 - ``HummingbirdCore``
 - ``HummingbirdHTTP2``
+- ``HummingbirdWebSocket``

Hummingbird.docc/HummingbirdWebSocket/HummingbirdWebSocket.md

@@ -8,9 +8,50 @@ Adds support for upgrading HTTP connections to WebSocket.
 
 ## Overview
 
-WebSockets is a protocol providing simultaneous two-way communication channels over a single TCP connection. Unlike HTTP where client requests are paired with a server response, WebSockets allow for communication in both directions asynchronously. It is designed to work over the HTTP ports 80 and 443 via an upgrade process where an initial HTTP request is sent before the connection is upgraded to a WebSocket connection.
+WebSockets is a protocol providing simultaneous two-way communication channels over a single TCP connection. Unlike HTTP where client requests are paired with a server response, WebSockets allow for communication in both directions asynchronously, for a prolonged period of time.
 
-HummingbirdWebSocket allows you to implement an HTTP1 server with WebSocket upgrade.
+It is designed to work over the HTTP ports 80 and 443 via an upgrade process where an initial HTTP request is sent before the connection is upgraded to a WebSocket connection.
+
+HummingbirdWebSocket allows you to implement an HTTP1 server with WebSocket upgrade. HummingbirdWebSocket is Autobahn compliant and supports both compression and TLS.
+
+To add `HummingbirdWebSocket` to your project, run the following command in your Terminal:
+
+```sh
+# From the root directory of your project
+# Where Package.swift is located
+
+# Add the package to your dependencies
+swift package add-dependency https://github.com/hummingbird-project/hummingbird-websocket.git --from 2.2.0
+
+# Add the target dependency to your target
+swift package add-target-dependency HummingbirdWebSocket <MyApp> --package hummingbird-websocket
+```
+
+Make sure to replace `<MyApp>` with the name of your App's target.
+
+To integrate `HummingbirdWebSocket` into your project, you need to specify WebSocket support in your `Application`'s configuration:
+
+```swift
+import Hummingbird
+import HummingbirdWebSocket
+
+let app = Application(
+    router: router,
+    server: .http1WebSocketUpgrade { request, channel, logger in
+        // upgrade if request URI is "/ws"
+        guard request.uri == "/ws" else { return .dontUpgrade }
+        // The upgrade response includes the headers to include in the response and 
+        // the WebSocket handler
+        return .upgrade([:]) { inbound, outbound, context in
+            // Send "Hello" to the client
+            try await outbound.write(.text("Hello"))
+            // Ending this function automatically closes the connection
+        }
+    }
+)
+```
+
+Get started with the WebSockets here: <doc:WebSocketServerUpgrade>
 
 ## Topics