doc and extracted more local variables
replace personnal paths with descriptive hint and update readme