diff --git a/README.md b/README.md
index 387a56e4..86059ed6 100644
--- a/README.md
+++ b/README.md
@@ -88,6 +88,20 @@ pub enum DataStoreError {
   }
   ```
 
+  The attribute accepts complex expressions as well. For example, if you'd like
+  to transform an `Option<T>` into something else in the error messsage, you
+  can do so.
+
+  ```rust
+  #[derive(Error, Debug)]
+  pub enum Error {
+      #[error("lost connection to the server: {}", match .0 {
+          Some(reason) => &reason,
+          None => "unknown reason",
+      })]
+      ConnectionLost(Option<String>),
+  }
+
 - A `From` impl is generated for each variant containing a `#[from]` attribute.
 
   Note that the variant must not contain any other fields beyond the source
diff --git a/src/lib.rs b/src/lib.rs
index 42006e36..8df3125c 100644
--- a/src/lib.rs
+++ b/src/lib.rs
@@ -98,6 +98,22 @@
 //!   }
 //!   ```
 //!
+//!   The attribute accepts complex expressions as well. For example, if you'd like
+//!   to transform an `Option<T>` into something else in the error messsage, you
+//!   can do so.
+//!
+//!   ```rust
+//!   # use thiserror::Error;
+//!
+//!   #[derive(Error, Debug)]
+//!   pub enum Error {
+//!       #[error("lost connection to the server: {}", match .0 {
+//!           Some(reason) => &reason,
+//!           None => "unknown reason",
+//!       })]
+//!       ConnectionLost(Option<String>),
+//!   }
+//!
 //! - A `From` impl is generated for each variant containing a `#[from]`
 //!   attribute.
 //!