More examples of how to construct Arrays

[alamb]

Is your feature request related to a problem or challenge? Please describe what you are trying to do.

Imagine a user who wants to make a StringArray. They go to the docs, and find StringArray
And now what?

Describe the solution you'd like
Adding an example (or a pointer to such an example) to each of the Array types (e.g things that implement Array of how to construct them (from iterators) such as

let array = StringArray::from(vec![Some("foo"), None, Some("bar")]);

(and taking inspiration from the examples in the main docs https://docs.rs/arrow/4.0.0/arrow/index.html)

would probably be super helpful.

Describe alternatives you've considered
A clear and concise description of any alternative solutions or features you've considered.

Additional context
Add any other context or screenshots about the feature request here.

[novemberkilo]

Thanks for the write up @alamb - I will pick this up if that’s ok?

[novemberkilo]

@alamb it looks like there are several other array types that do not have examples. Shall I continue in the same vein as #330 to annotate them with doctests?

For example, BooleanArray has no examples, and none of the methods appear to have documentation either.

https://docs.rs/arrow/4.0.0/arrow/array/struct.BooleanArray.html
https://docs.rs/arrow/4.0.0/arrow/array/struct.BooleanArray.html#method.builder

[alamb]

@novemberkilo yes I think adding examples / documentation to all the array types (including Boolean array) would be great!

Thank you so much

[alamb]

Reopening as @novemberkilo has plans for additional PRs