OPENIG-417 Apply fixes for doc review comments

git-svn-id: https://svn.forgerock.org/openig/trunk@805 dbb9e58e-28e6-4ce0-90e8-f11d9605b710