WL-2827 improve the signup javadoc