improve readme files + correct small bug in analysis