adjusting examples + readme + cleanup