improved example, readme updates