Update some of the docs in event_federation
Add a few more comments to the federation handler