JAL-1668 updated documentation