alamb commented on a change in pull request #474:
URL: https://github.com/apache/arrow-rs/pull/474#discussion_r656455542
##########
File path: arrow/src/array/array_list.rs
##########
@@ -50,6 +50,9 @@ impl OffsetSizeTrait for i64 {
}
}
+/// Generic struct for a primitive Array
+///
+/// Instead of using `GenericListArray` directly, consider using `ListArray`
or `LargeListArray`
Review comment:
I think it is valuable if the comment on `GenericListArray` pointed
(likely) novice users towards `ListArray` and `LargeListArray` as their
existence may not be obvious at this stage
How about making the wording less judgemental such as
```
For non generic lists, you may wish to consider using [`ListArray`] or
[`LargeListArray`]`
```
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
[email protected]
