README revision and examples