doc: cleanup events docs
This PR depends on #36001 which must land first, and addresses a concern over the documentation structure raised in the review of #36001.
The first commit is from #36001
/cc @trott
Checklist
-
make -j4 test
(UNIX), orvcbuild test
(Windows) passes -
documentation is changed or added -
commit message follows commit guidelines