[DOCS] Improve documentation

[lohnn]

We need a more exhaustive documentation, such as looking through the generated dart doc to make sure it is excellent.

But also, more importantly improve the README to have more examples, a few chapters and more explanations.