llama90 commented on issue #41907: URL: https://github.com/apache/arrow/issues/41907#issuecomment-2143231856
After a quick look, it seems that the examples for `Table` and `RecordBatch` are being used redundantly. This is because a `Table` is made up of multiple `RecordBatch` objects, so they work with the same logic internally, and the documentation is generated through docstrings. From a user perspective, without understanding the concepts (What is a `Table`? What is a `RecordBatch`?), or when copying and pasting code to use with other code, it might lead to unintended results. On the other hand, from a development and documentation management perspective, the current form doesn’t seem incorrect. What are your thoughts on this? cc @AlenkaF -- 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]
