update documentation

Author: h908714124

README.md

@@ -1,13 +1,10 @@
 [![either](https://maven-badges.herokuapp.com/maven-central/io.github.jbock-java/either/badge.svg?subject=either)](https://maven-badges.herokuapp.com/maven-central/io.github.jbock-java/either)
 
-### jbock.util::either
+The `Either` type is closely related to `Optional`, but can have different "failure" states, other than only *empty*.
+An `Either` can be used to properly return error messages from stream operations,
+or as a lightweight alternative to exceptions.
 
-`Either` is a close relative of `Optional`, but can have different "failure" states, other than only *empty*.
-This has many useful applications. For example, an `Either` can be used to report error conditions from stream operations.
-
-There are various good alternatives,
-like [vavr](https://github.com/vavr-io/vavr), [fugue](https://bitbucket.org/atlassian/fugue/src/master/), and [lambda](https://github.com/palatable/lambda).
-This particular project emphasizes interoperability with `Optional`.
-Since `java.util.Optional` can't be extended, `jbock.util::either` comes with its own copy named `io.jbock.util.Optional`,
-with two additional methods `orElseLeft()` and `flatMapLeft()`.
+There are several popular libraries that offer an `Either` type,
+including [vavr](https://github.com/vavr-io/vavr), [fugue](https://bitbucket.org/atlassian/fugue/src/master/), and [lambda](https://github.com/palatable/lambda).
+This particular `Either` might be easier to work with, especially if you're already familiar with `Optional`.