TYRUS-197: user guide update/refactor

git-svn-id: https://svn.java.net/svn/tyrus~source-code-repository/trunk@736 aa68c1a9-5198-4982-ce7d-eee0ef5d8746