Rewrote the federation developer documentation (#1911)