better docs for list method
list_flat method