updated readme with logging and caching