enrich examples in docs
Merge pull request #29 from bsadeh/better_docs

Better docs