improve docs on list containers