Documentation improvements to prepare the switch to new syntax.

Signed-off-by: Martin Raspaud <martin.raspaud@smhi.se>