docs: update example descriptions and add WebClientExample

Author: devopvoid

docs/examples.md

@@ -2,9 +2,9 @@
 
 This section provides an overview of the example applications included in the `webrtc-examples` Maven module. These examples demonstrate various features and capabilities of the webrtc-java library.
 
-## PeerConnectionExample
+## PeerConnection
 
-The `PeerConnectionExample` demonstrates how to set up a peer connection with audio and video tracks to be able to send and receive media.
+The [`PeerConnectionExample`](https://github.com/devopvoid/webrtc-java/blob/master/webrtc-examples/src/main/java/dev/onvoid/webrtc/examples/PeerConnectionExample.java) demonstrates how to set up a peer connection with audio and video tracks to be able to send and receive media.
 
 **Key features demonstrated:**
 - Creating a PeerConnectionFactory
@@ -15,9 +15,9 @@ The `PeerConnectionExample` demonstrates how to set up a peer connection with au
 
 This example provides a foundation for building WebRTC applications that need to handle audio and video communication.
 
-## WhepExample
+## WHEP
 
-The `WhepExample` demonstrates an implementation of WebRTC HTTP Egress Protocol (WHEP) client, which is a standardized protocol for WebRTC ingestion.
+The [`WhepExample`](https://github.com/devopvoid/webrtc-java/blob/master/webrtc-examples/src/main/java/dev/onvoid/webrtc/examples/WhepExample.java) demonstrates an implementation of WebRTC HTTP Egress Protocol (WHEP) client, which is a standardized protocol for WebRTC ingestion.
 
 **Key features demonstrated:**
 - Setting up a WebRTC peer connection
@@ -27,9 +27,9 @@ The `WhepExample` demonstrates an implementation of WebRTC HTTP Egress Protocol
 
 This example is useful for applications that need to receive media streams from WHEP-compatible servers, such as live streaming platforms.
 
-## CodecListExample
+## Codec List
 
-The `CodecListExample` demonstrates how to list all supported codecs with the WebRTC peer-connection-factory.
+The [`CodecListExample`](https://github.com/devopvoid/webrtc-java/blob/master/webrtc-examples/src/main/java/dev/onvoid/webrtc/examples/CodecListExample.java) demonstrates how to list all supported codecs with the WebRTC peer-connection-factory.
 
 **Key features demonstrated:**
 - Creating a PeerConnectionFactory
@@ -38,9 +38,9 @@ The `CodecListExample` demonstrates how to list all supported codecs with the We
 
 This example is useful for understanding what codecs are available on the current system, which can help with debugging compatibility issues or optimizing media quality.
 
-## DesktopVideoExample
+## Desktop Video
 
-The `DesktopVideoExample` demonstrates how to set up a peer connection with a desktop video source for screen or window capture.
+The [`DesktopVideoExample`](https://github.com/devopvoid/webrtc-java/blob/master/webrtc-examples/src/main/java/dev/onvoid/webrtc/examples/DesktopVideoExample.java) demonstrates how to set up a peer connection with a desktop video source for screen or window capture.
 
 **Key features demonstrated:**
 - Creating a PeerConnectionFactory
@@ -52,6 +52,28 @@ The `DesktopVideoExample` demonstrates how to set up a peer connection with a de
 
 This example is particularly useful for applications that need to implement screen sharing or remote desktop functionality.
 
+## Web Client
+
+The [`WebClientExample`](https://github.com/devopvoid/webrtc-java/blob/master/webrtc-examples/src/main/java/dev/onvoid/webrtc/examples/web/WebClientExample.java) demonstrates how to combine WebSocket signaling with WebRTC peer connections for real-time communication between web and Java clients.
+
+**Key features demonstrated:**
+- Connecting to a signaling server using WebSockets
+- Setting up audio and video media tracks
+- Creating and managing WebRTC peer connections
+- Handling signaling messages (offers, answers, ICE candidates)
+- Joining and leaving rooms for multi-user communication
+- Using custom audio sources for audio streaming
+
+This example is valuable for applications that need to establish WebRTC connections between Java clients and web browsers, enabling cross-platform real-time communication with audio and video.
+
+**Note:** Before running the WebClientExample, you need to start the WebServer first. The WebServer provides the signaling service required for WebRTC connection establishment:
+
+```bash
+mvn exec:java -D"exec.mainClass=dev.onvoid.webrtc.examples.web.server.WebServer"
+```
+
+And the browser client is reachable at this url: https://localhost:8443
+
 
 ## Running the Examples
 
@@ -64,4 +86,10 @@ For example, to run the `CodecListExample`:
 mvn exec:java -D"exec.mainClass=dev.onvoid.webrtc.examples.CodecListExample"
 ```
 
-Note that these examples focus on setting up the local components for WebRTC communication. In a real application, you would need to establish a connection with a remote peer through a signaling channel (e.g., WebSocket).
+Or to run the `WebClientExample`:
+
+```bash
+mvn exec:java -D"exec.mainClass=dev.onvoid.webrtc.examples.web.WebClientExample"
+```
+
+Note that these examples focus on setting up the local components for WebRTC communication. In a real application, you would need to establish a connection with a remote peer through a signaling channel (e.g., WebSocket). The `WebClientExample` demonstrates this by connecting to a signaling server.