diff --git a/examples/index.rs b/examples/index.rs
index 57a1a8a..bdd97a3 100644
--- a/examples/index.rs
+++ b/examples/index.rs
@@ -1,3 +1,4 @@
+/// Benchmark regular indexing flow (using JSONRPC), don't persist the resulting index.
 extern crate electrs;
 extern crate error_chain;
 
diff --git a/examples/load.rs b/examples/load.rs
index a9cbd94..ed97752 100644
--- a/examples/load.rs
+++ b/examples/load.rs
@@ -1,3 +1,5 @@
+/// Benchmark bulk indexing flow (using local blk*.dat files).
+/// Persist (and compact) the resulting index
 extern crate electrs;
 
 #[macro_use]