adding docs to README, moving examples