diff --git a/packages/stream-management/README.md b/packages/stream-management/README.md
index 296b8ad4..d28596e5 100644
--- a/packages/stream-management/README.md
+++ b/packages/stream-management/README.md
@@ -10,7 +10,13 @@ When the session is resumed the `online` event is not emitted as session resumpt
 However `entity.status` is set to `online`.
 If the session fails to resume, entity will fallback to regular session establishment in which case `online` event will be emitted.
 
-Automatically responds to acks but does not support requesting acks yet.
+Automatically responds to acks and requests them. Also requests periodically even if you haven't sent anything. If server fails to respond to a request, the module triggers a reconnect.
+
+## Events
+
+**resumed**: Indicates that the connection was resumed (so online with no online event)
+**fail**: Indicates that a stanza failed to send to the server and will not be retried
+**ack**: Indicates that a stanza has been acknowledged by the server
 
 ## References