JERSEY-1858: URIs and Links section.

- PS2: incorporated review comments.

Change-Id: I5827c29828189c6dc043a9bcb03a6967f05a545e
Signed-off-by: Marek Potociar <marek.potociar@oracle.com>