diff --git a/src/polychord/mpi_utils.F90 b/src/polychord/mpi_utils.F90
index 67058906..b8ee83eb 100644
--- a/src/polychord/mpi_utils.F90
+++ b/src/polychord/mpi_utils.F90
@@ -368,11 +368,16 @@ end subroutine throw_point
 
 
 
-    !============= Generating live points =================
-    !> 
-    !!
-    !! This a process by which the administrator 'scatters' live points
-    !! to all workers.
+    !============== Scattering/gathering live points ====================
+    ! This a process by which the administrator 'scatters' live points
+    ! to all workers, and gathers them back again.
+    !
+    ! This is used in the initial generation of live points.
+    ! scatter_points:
+    !    root     ---->   all workers
+    !
+    ! gather_points:
+    ! all workers ---->   root
 
     !> Administrator scatters live points to all workers.
     !!