doc: Edit the SPI driver APIs
doc: Edit the SPI driver APIs

Edit public API details for clarity, grammar, punctuation found
on file spi.h

Made consistent use of @retval to document return values.

Used imperative verbs for all @brief descriptions.

Change-Id: Ie53eeeb79d399e8474fe7341a396f5437c2999dc
Signed-off-by: Rodrigo Caballero <e74c61adb7ade025bc8e83a25052d36636c989a9@intel.com>

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