updates docs for federation upstream types
Merge branch 'docs_for_federation' into types_for_federation
updates docs