more explanation and fixes.