update loop documentation