+ Improved doxygen documentation
+ Removing some notes related to CMSIS consistency and compatibility as scope has shifted a bit

Signed-off-by: Olli Vanhoja <olli.vanhoja@ninjaware.fi>