JERSEY-2266: "Fix broken link in user guide"
Fixed links to javadoc.
Removed links to non public api.

Change-Id: Ic12fcd4cecb83c2752f191a5ae8d02abb21cda21