doc: document AddChannel/RemoveChannel

Signed-off-by: René Jochum <rene@jochum.dev>

Author: jochumdev

doc/events.md

@@ -23,7 +23,10 @@ disconnected are not resent.
 
 When using the Go client, handlers registered through `AddHandler` are called concurrently and may therefore observe
 events out of order. Use `AddChannel` instead to receive the events on a channel, which delivers them one at a time and
-in the order they arrived. The channel is closed once the listener is done, so it can be consumed with a `range` loop.
+in the order they arrived, and is closed once the listener ends. Its size argument sets how far behind the reader may
+fall before the listener is dropped.
+
+Use `RemoveChannel` to stop receiving on one channel without disconnecting the whole listener.
 
 ## Event structure
 
@@ -98,8 +101,8 @@ type: lifecycle
 | `image-alias-deleted`                  | An alias has been deleted for an existing image.                      | `target`: the original instance.                                                                     |
 | `image-alias-renamed`                  | The alias for an existing image has been renamed.                     | `old_name`: the previous name.                                                                       |
 | `image-alias-updated`                  | The configuration for an image alias has changed.                     | `target`: the original instance.                                                                     |
-| `instance-agent-started`               | The instance agent has connected to the host.                        |                                                                                                      |
-| `instance-agent-stopped`               | The instance agent has disconnected from the host.                   |                                                                                                      |
+| `instance-agent-started`               | The instance agent has connected to the host.                         |                                                                                                      |
+| `instance-agent-stopped`               | The instance agent has disconnected from the host.                    |                                                                                                      |
 | `image-created`                        | A new image has been added to the image store.                        | `type`: `container` or `vm`.                                                                         |
 | `image-deleted`                        | The image has been deleted from the image store.                      |                                                                                                      |
 | `image-refreshed`                      | The local image copy has updated to the current source image version. |                                                                                                      |