Ready for 0.1.0 release

Author: sobolevn

README.md

@@ -14,6 +14,20 @@ Monads for `python` made simple and safe.
 - No operator overloading or other unpythonic stuff that makes your eyes bleed
 
 
+## What's inside?
+
+We have several the most iconic monads inside:
+
+- [`Result`, `Failure`, and `Success`](https://dry-monads.readthedocs.io/en/latest/pages/either.html) (also known as `Either`, `Left`, and `Right`)
+- `Maybe`, `Some`, and `Nothing` (currently WIP)
+- `Just` (currently WIP)
+
+We also care about code readability and developer experience,
+so we have included some useful features to make your life easier:
+
+- [Do notation](https://dry-monads.readthedocs.io/en/latest/pages/do-notation.html)
+
+
 ## Inspirations
 
 This module is heavily based on:

docs/index.rst

@@ -7,6 +7,7 @@ Contents
   :maxdepth: 2
   :caption: Userguide
 
+  pages/monad.rst
   pages/either.rst
   pages/do-notation.rst
 

docs/pages/do-notation.rst

@@ -120,6 +120,12 @@ and then return a simple ``Failure`` monad.
       user creation-->>pipeline: returns Failure(http status) if fails
       user creation-->>pipeline: returns Success(user) if user is created
 
+See, do notation allows you to write simple yet powerful pipelines
+with multiple and complex steps.
+And at the same time the produced code is simple and readable.
+
+And that's it!
+
 API Reference
 -------------
 

docs/pages/monad.rst

@@ -0,0 +1,10 @@
+Monad: the concept
+==================
+
+API Reference
+-------------
+
+.. autoclasstree:: dry_monads.primitives.monad
+
+.. automodule:: dry_monads.primitives.monad
+   :members: