CR-3948 Fix for OPENIG-183: Document changes due to integration of the federation component

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