docs: Apply suggestions from code review

Co-authored-by: Leo <[email protected]>

Author: 0xNeshi

src/event_scanner/scanner/mod.rs

@@ -17,8 +17,9 @@
 //!
 //! ## Backpressure and lag
 //!
-//! Subscription streams are buffered. If a consumer cannot keep up and the internal broadcast
-//! channel drops messages, the corresponding subscription yields [`ScannerError::Lagged`].
+//! Subscription streams are buffered. If a consumer processes events too slowly and the
+//! internal buffer fills up, the stream yields [`ScannerError::Lagged`] and some events
+//! may be skipped.
 //!
 //! # Reorgs and finality
 //!

src/lib.rs

@@ -1,8 +1,10 @@
-//! Event-Scanner is a Rust library for streaming EVM event logs.
+//! Event-Scanner is a library made to stream EVM event logs.
 //!
-//! The main entry point is [`EventScanner`], configured via [`EventScannerBuilder`] in one of the
-//! supported modes (for example [`Historic`] or [`Live`]). Consumers register one or more event
-//! subscriptions via [`EventScanner::subscribe`] and then start the scanner.
+//! The main entry point is [`EventScanner`], built via [`EventScannerBuilder`] in one of the
+//! supported modes (e.g. [`Historic`] or [`Live`]).
+//!
+//! After constructing a scanner, register one or more event subscriptions with
+//! [`EventScanner::subscribe`], then call [`EventScanner::start`] to begin streaming.
 //!
 //! # Stream items
 //!