list: tidy the doc comments and tests#1162

bbasata merged 2 commits intomainhashicorp/terraform-plugin-framework:mainfrom

revisit-list-packagehashicorp/terraform-plugin-framework:revisit-list-packageCopy head branch name to clipboard