JERSEY-1862: user guide "mbw" chapter

- PS2: incorporated review comments, fixed examples in "resources" chapter, reordered chapters in user guide, fixed Jersey apidocs links in the generated documentation.

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