doc: Revise description for microkernel event objects
doc: Revise description for microkernel event objects

Revises and supplements information on concepts, use cases, and
how to define an event.

Change-Id: I1de8c87d069288c14d6f378d96590fcc3d569801
Signed-off-by: Allan Stephens <1038bc33971d2c23c8e2eee8dd6938c077db52dc@windriver.com>

32bitmicro/zephyr,bigdinotech/zephyr,galak/zephyr,finikorg/zephyr,bboozzoo/zephyr,finikorg/zephyr,coldnew/zephyr-project-fork,Vudentz/zephyr,runchip/zephyr-cc3220,aceofall/zephyr-iotos,runchip/zephyr-cc3220,explora26/zephyr,galak/zephyr,32bitmicro/zephyr,fbsder/zephyr,nashif/zephyr,GiulianoFranchetto/zephyr,mirzak/zephyr-os,bigdinotech/zephyr,erwango/zephyr,coldnew/zephyr-project-fork,mbolivar/zephyr,kraj/zephyr,runchip/zephyr-cc3200,mbolivar/zephyr,nashif/zephyr,aceofall/zephyr-iotos,Vudentz/zephyr,Vudentz/zephyr,Vudentz/zephyr,bigdinotech/zephyr,zephyrproject-rtos/zephyr,fbsder/zephyr,fbsder/zephyr,kraj/zephyr,fractalclone/zephyr-riscv,aceofall/zephyr-iotos,jamesonwilliams/zephyr-kernel,pklazy/zephyr,explora26/zephyr,coldnew/zephyr-project-fork,galak/zephyr,aceofall/zephyr-iotos,nashif/zephyr,explora26/zephyr,punitvara/zephyr,mbolivar/zephyr,ldts/zephyr,bboozzoo/zephyr,fbsder/zephyr,punitvara/zephyr,runchip/zephyr-cc3220,rsalveti/zephyr,bboozzoo/zephyr,pklazy/zephyr,zephyrproject-rtos/zephyr,rsalveti/zephyr,fractalclone/zephyr-riscv,finikorg/zephyr,zephyrproject-rtos/zephyr,ldts/zephyr,runchip/zephyr-cc3200,kraj/zephyr,runchip/zephyr-cc3200,holtmann/zephyr,zephyrproject-rtos/zephyr,holtmann/zephyr,sharronliu/zephyr,punitvara/zephyr,runchip/zephyr-cc3200,32bitmicro/zephyr,tidyjiang8/zephyr-doc,mirzak/zephyr-os,rsalveti/zephyr,ldts/zephyr,aceofall/zephyr-iotos,sharronliu/zephyr,punitvara/zephyr,mirzak/zephyr-os,erwango/zephyr,holtmann/zephyr,bigdinotech/zephyr,ldts/zephyr,nashif/zephyr,GiulianoFranchetto/zephyr,tidyjiang8/zephyr-doc,kraj/zephyr,galak/zephyr,jamesonwilliams/zephyr-kernel,erwango/zephyr,Vudentz/zephyr,fbsder/zephyr,jamesonwilliams/zephyr-kernel,coldnew/zephyr-project-fork,fractalclone/zephyr-riscv,erwango/zephyr,finikorg/zephyr,runchip/zephyr-cc3200,zephyriot/zephyr,32bitmicro/zephyr,explora26/zephyr,jamesonwilliams/zephyr-kernel,sharronliu/zephyr,erwango/zephyr,sharronliu/zephyr,jamesonwilliams/zephyr-kernel,rsalveti/zephyr,bboozzoo/zephyr,zephyriot/zephyr,runchip/zephyr-cc3220,coldnew/zephyr-project-fork,tidyjiang8/zephyr-doc,nashif/zephyr,galak/zephyr,holtmann/zephyr,tidyjiang8/zephyr-doc,bigdinotech/zephyr,mirzak/zephyr-os,kraj/zephyr,mbolivar/zephyr,mbolivar/zephyr,GiulianoFranchetto/zephyr,sharronliu/zephyr,ldts/zephyr,punitvara/zephyr,holtmann/zephyr,32bitmicro/zephyr,pklazy/zephyr,finikorg/zephyr,rsalveti/zephyr,mirzak/zephyr-os,tidyjiang8/zephyr-doc,zephyrproject-rtos/zephyr,GiulianoFranchetto/zephyr,Vudentz/zephyr,explora26/zephyr,fractalclone/zephyr-riscv,runchip/zephyr-cc3220,bboozzoo/zephyr,zephyriot/zephyr,zephyriot/zephyr,GiulianoFranchetto/zephyr,zephyriot/zephyr,fractalclone/zephyr-riscv,pklazy/zephyr,pklazy/zephyr