diff --git a/src/subscribers.rs b/src/subscribers.rs
index 8a4434167..153246d12 100644
--- a/src/subscribers.rs
+++ b/src/subscribers.rs
@@ -1,9 +1,9 @@
 //! The `subscribers` module defines data structures to keep track of nodes on the network.
 //! The network is arranged in layers:
 //!
-//! * layer 0 - leader
-//! * layer 1 - as many nodes as we can fit to quickly get reliable `2/3+1` finality
-//! * layer 2 - everyone else, if layer 1 is `2^10`, layer 2 should be `2^20` number of nodes
+//! * layer 0 - Leader.
+//! * layer 1 - As many nodes as we can fit to quickly get reliable `2/3+1` finality
+//! * layer 2 - Everyone else, if layer 1 is `2^10`, layer 2 should be able to fit `2^20` number of nodes.
 //!
 //! It's up to the external state machine to keep this updated.
 use packet::Blob;