update documentation, typos, better examples