update readme with some informative documentation