Update federation docs to point to specs.o.org

Currently, some parts of the federation docs points to links on
github.com. We should use the new specs.o.org/keystone/api links
instead.

Change-Id: I155e7491a9033c794ef7582bca18286b1b4a80aa
Merge "Update federation docs to point to specs.o.org"