chore: update README and add MODULE_FEDERATION/md

[jbinda]

Summary

Add more verbose README related with examples

P.S. originator of the content was @andrewworld - however he faced some issue with access so I populated PR with those changes

Test plan