doc: Edit common_kernel_clocks.rst
doc: Edit common_kernel_clocks.rst

Corrected typos and added headings to API section to
enhance readability.

Change-Id: I5a43edfdd6a8ac7735d8f00823058f6a2661439f
Signed-off-by: L.S. Cook <2c8ffdbb27eb9faeeac367751f77804563aa8470@intel.com>

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