[#390] Add readme

examples/cxx/event_based_communication/README.md

@@ -1 +1,35 @@
-# asd
+# Event-Based Communication
+
+## Running The Example
+
+This example demonstrates iceoryx2's event multiplexing mechanism in a more
+complex setup. The iceoryx2 `Publisher` and `Subscriber` are integrated into
+custom `ExamplePublisher` and `ExampleSubscriber` classes, which also
+incorporate an additional iceoryx2 `Notifier` and `Listener`. This setup
+enables automatic event emission whenever an `ExamplePublisher` or
+`ExampleSubscriber` is created or dropped. Additionally, events are emitted
+whenever a new `Sample` is sent or received.
+
+When a `class` inherits from `FileDescriptorBased`, it can be attached to a
+`WaitSet`. Both `ExamplePublisher` and `ExampleSubscriber` implement this
+interface by forwarding calls to their underlying `Listener`, which already
+provides an implementation of `FileDescriptorBased`.
+
+The `WaitSet` notifies the user of the origin of an event notification. The
+user can then acquire the `EventId` from the `Listener`. Based on the value of
+the `EventId`, the user can identify the specific event that occurred and take
+appropriate action.
+
+### Terminal 1
+
+```sh
+./target/ffi/build/examples/cxx/event_based_communication/example_cxx_event_based_communication_publisher
+```
+
+### Terminal 2
+
+```sh
+./target/ffi/build/examples/cxx/event_based_communication/example_cxx_event_based_communication_subscriber
+```
+
+Feel free to run multiple publishers or subscribers in parallel.