Example why our TryFRom is better

Author: rklaehn

README.md

@@ -41,8 +41,24 @@ Here we define conversions from `GetRequest` to `StoreRequest`, from `StoreReque
 
 The generated [From] conversions are straightforward. Obviously it is always possible to convert from an enum case to the enum itself.
 
-We also generate [TryFrom] conversions from the enum to each variant, as well as from a reference to the enum to a reference to the variant. The conversions that take a value are different than the ones from [derive_more]: they return
-the unmodified input in the error case, allowing to chain conversion attempts.
+We also generate [TryFrom] conversions from the enum to each variant, as well as from a reference to the enum to a reference to the variant.
+
+The conversions that take a value are different than the ones from [derive_more]: they return the unmodified input in the error case, allowing to chain conversion attempts.
+
+```rust
+let request = ...
+match GetRequest::try_from(request) {
+  Ok(get) => // handle get request
+  Err(request) => {
+    // I still got the request and can try something else
+    match PutRequest::try_from(request) {
+      ...
+    }
+  }
+}
+```
+
+The conversions that take a reference just return a `&'static str` as the error type. References are `Copy`, so we can always retry anyway.
 
 [From]: https://doc.rust-lang.org/std/convert/trait.From.html
 [TryFrom]: https://doc.rust-lang.org/std/convert/trait.TryFrom.html