diff --git a/src/indexer/segment_serializer.rs b/src/indexer/segment_serializer.rs
index dee306bb3..dab5095df 100644
--- a/src/indexer/segment_serializer.rs
+++ b/src/indexer/segment_serializer.rs
@@ -31,7 +31,7 @@ impl SegmentSerializer {
                 store_write,
                 crate::store::Compressor::None,
                 0, // we want random access on the docs, so we choose a minimal block size. Every
-                // doc will be flushed
+                // doc will get its own block.
                 settings.docstore_compress_dedicated_thread,
             )?
         } else {
diff --git a/src/indexer/segment_writer.rs b/src/indexer/segment_writer.rs
index 9859beaee..91347d0d1 100644
--- a/src/indexer/segment_writer.rs
+++ b/src/indexer/segment_writer.rs
@@ -393,8 +393,8 @@ fn remap_and_write(
             serializer
                 .segment()
                 .open_read(SegmentComponent::TempStore)?,
-            1, /* The docstore is configured for tiny docs for fast random access, we don't need
-                * the the cache */
+            1, /* The docstore is configured to have one doc per block, and each doc is accessed
+                * only once: we don't need caching. */
         )?;
         for old_doc_id in doc_id_map.iter_old_doc_ids() {
             let doc_bytes = store_read.get_document_bytes(old_doc_id)?;