diff --git a/lighthouse/state/transition/shuffling/README.md b/lighthouse/state/transition/shuffling/README.md
new file mode 100644
index 0000000000..b0f4f5245c
--- /dev/null
+++ b/lighthouse/state/transition/shuffling/README.md
@@ -0,0 +1,2 @@
+This module includes the fundamental shuffling function. It does not do the
+full validator delegation amongst slots.