documentation improved, results made more obvious