chore(docs): improve description and api examples