JERSEY-1866: documentation "sse" chapter.

- PS2: incorporated comments, rebased to latest master.

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