include: sensing: doc: documentation improvements

- Move sensing documentation in the "OS Services" group
  and clean up group declarations
- Add missing documentation for the Sensing Subsystem API and complete
  existing docs when it was too terse
- Other grammar/cosmetic improvements

Signed-off-by: Benjamin Cabé <benjamin@zephyrproject.org>