update readme plus add a couple more comments to scripts