updates docs for federation upstream and upstreamset types

I put this in a separate pull request in case you don't approve the other one immediately