properly document indexes of list