added more details to read me and official documentation