Add documentation to PR 550
Merge pull request #554 from liweinan/RESTEASY838-doc

add documentation to the patches in http://github.com/resteasy/Resteasy/pull/550