BVAL-420 JavaDoc improvements