JAL-1645 documentation tweaks