documenting lists and our one list function