1 files changed, 34 insertions, 0 deletions
diff --git a/README.md b/README.md
index 9a0e46b..ec04863 100644
--- a/README.md
+++ b/README.md
@@ -9,7 +9,41 @@
 A collection of helpful iterator adaptors for iterating over `Result<T, E>`.
 
 
+## Examples
 
+Here go some examples what you can do with the library.
+
+* Altering T in `Iterator<Item = Result<T, E>>`
+
+```rust
+iter.map(|r| r.map(|a| alter(a))) // stdlib
+iter.map_ok(|a| alter(a))         // resiter
+```
+
+
+* Altering T in `Iterator<Item = Result<T, E>>` with a function that might fail:
+
+```rust
+iter.map(|r| r.and_then(|a| alter(a))) // stdlib
+iter.and_then_ok(|a| alter(a))         // resiter
+```
+
+
+* Unpacking T in `Iterator<Item = Result<Option<T>, E>>`
+
+```rust
+iter.map(|r| r.and_then(|o| o.ok_or_else(|| error()))) // stdlib
+iter.inner_ok_or_else(|| error())                      // resiter
+```
+
+
+* Executing code for each error in `Iterator<Item = Result<T, E>>`
+
+```rust
+iter.map(|r| if let Err(e) = r { foo(); Err(e) } else { r })) // stdlib
+iter.map(|r| r.map_err(|e| { foo(); e }))                     // stdlib
+iter.on_err(|e| foo())                                        // resiter
+```
 
 
 ## License