adding initial setup for federated nodes, plus some doc tweaks