diff --git a/changelog.d/6940.doc b/changelog.d/6940.doc
new file mode 100644
index 0000000000..8c75f48d3d
--- /dev/null
+++ b/changelog.d/6940.doc
@@ -0,0 +1 @@
+Clean up and update docs on setting up federation.