doc: misc Sphinx/ReST lint fixes

fixed some ReST/Sphinx lint issues missed in earlier cleanups
prior to introducing Sphinx-linter in compliance check

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