refactor: comments, reorg, nicer code in list functions
refactor