readme, tiny fixes, beter docs on example