Better documentation

[dg-pb]

Hello, lovely package.

It seems that it has a lot of features that are not documented.

Would be nice to see a docstring of Retrying.__init__ or actual retry decorator.

In addition, examples are very good, but also do not cover complete functionality.

Thanks for considering.