--- a/mod_sasl2/README.md Thu Oct 13 22:48:28 2022 +0100
+++ b/mod_sasl2/README.md Thu Oct 13 22:48:57 2022 +0100
@@ -5,3 +5,16 @@
---
Experimental implementation of [XEP-0388: Extensible SASL Profile]
+
+## Developers
+
+mod_sasl2 provides some events you can hook to affect aspects of the
+authentication process:
+
+- `advertise-sasl-features`
+- `sasl2/c2s/success`
+ - Priority 1000: Session marked as authenticated, success response created (`event.success`)
+ - Priority -1000: Success response sent to client
+ - Priority -1500: Updated <stream-features/> sent to client
+- `sasl2/c2s/failure`
+- `sasl2/c2s/error`