thisisnic opened a new issue, #36271: URL: https://github.com/apache/arrow/issues/36271
### Describe the enhancement requested In the process of #35545 it's become apparent that there are a few ways in which we can improve how we document our data containers: - [ ] Split out docs for `array()` from other Arrays, so we can then list them in different subsections of the reference page - [ ] Update the title for `chunked_array()`, `record_batch()`, `arrow_table()`, `buffer()`, `vctrs_extension_array()`, and `vctrs_extension_type()` to start with "Create a ..." to make the intention of the function more clear - [ ] Update the title for `read_schema()` to begin with a capital letter - [ ] Update the following functions' titles to being with a verb: `schema()`, `field()`, `data-type`, `new_extension_type`, `vctrs_extension_array`,  ### Component(s) R -- 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. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
