AlenkaF commented on issue #41907:
URL: https://github.com/apache/arrow/issues/41907#issuecomment-2144723058

   These docstrings were united between `Table` and `RecordBatch` when the 
parent class `_Tabular` was added to consolidate `Table` and `RecordBatch` 
functionality (see https://github.com/apache/arrow/issues/36129). In these 
consolidated methods docstrings there is a text added:
   
   > Table (works similarly for RecordBatch)
   
   that should help with understanding why `Table` example is used for 
`RecordBatch` also. If you look in the `RecordBatch` class examples, you have 
the "correct" class usage.
   
   For me this is quite clear but can imagine from a user's perspective it 
might be confusing. If you have a good proposal for clearer content in the 
consolidated methods examples, I am definitely open for improvements.


-- 
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]

Reply via email to