new  more verbose readme