[doc] document client events as well