clarified and expanded readme

plus added an example