JAL-1645 yet more documentation tweaks