JERSEY-1957: update doc comments