diff --git a/storage/blockchain/src/service/mod.rs b/storage/blockchain/src/service/mod.rs
index 83868b29..049a0f24 100644
--- a/storage/blockchain/src/service/mod.rs
+++ b/storage/blockchain/src/service/mod.rs
@@ -37,6 +37,7 @@
 //! - The last [`BlockchainWriteHandle`] is dropped => writer thread exits
 //!
 //! TODO: update this when `ConcreteEnv` is removed
+//! 
 //! Upon dropping the [`cuprate_database::ConcreteEnv`]:
 //! - All un-processed database transactions are completed
 //! - All data gets flushed to disk (caused by [`Drop::drop`] impl on `ConcreteEnv`)
diff --git a/storage/service/src/reader_threads.rs b/storage/service/src/reader_threads.rs
index 601363af..72f619a0 100644
--- a/storage/service/src/reader_threads.rs
+++ b/storage/service/src/reader_threads.rs
@@ -28,9 +28,9 @@ pub fn init_thread_pool(reader_threads: ReaderThreads) -> Arc<ThreadPool> {
 }
 
 //---------------------------------------------------------------------------------------------------- ReaderThreads
-/// Amount of database reader threads to spawn
+/// Amount of database reader threads to spawn.
 ///
-/// This controls how many reader thread `service`'s
+/// This controls how many reader threads the [`DatabaseReadService`](crate::DatabaseReadService)
 /// thread-pool will spawn to receive and send requests/responses.
 ///
 /// # Invariant