doc: update events docs for consistency
This PR updates the events docs to remove language that is advised against in our doc style guide, and make default values consistent.
Checklist
-
make -j4 test
(UNIX), orvcbuild test
(Windows) passes -
documentation is changed or added -
commit message follows commit guidelines