docs on loops update