minor refactoring and docs for ListWidget