JAL-629 a bit more documentation