diff --git a/src/error.rs b/src/error.rs
index 277659cc..42c7393c 100644
--- a/src/error.rs
+++ b/src/error.rs
@@ -94,6 +94,12 @@ impl Needed {
 }
 
 /// Add parse error state to [`ParserError`]s
+///
+/// Needed for
+/// - [`Partial`][crate::stream::Partial] to track whether the [`Stream`] is [`ErrMode::Incomplete`].
+///   See also [`_topic/partial`]
+/// - Marking errors as unrecoverable ([`ErrMode::Cut`]) and not retrying alternative parsers.
+///   See also [`_tutorial/chapter_7#error-cuts`]
 #[derive(Debug, Clone, PartialEq)]
 pub enum ErrMode<E> {
     /// There was not enough data to determine the appropriate action