Confusion between array and list

I’m working on a PR to fix annotation, and I’m worried about the confusion between array and list. I think it’s better to use array, but it’s annoying that there are already vim.tbl_islist and so on. What do you guys think?