tweak documentation on loops