[ARROW-16058] [Python] Address docstrings for Table class, methods, attributes and constructor

• Type: Sub-task
• Status: Resolved
• Priority: Major
• Resolution: Fixed
• Fix Version/s: 8.0.0
• Component/s: Python
• Labels: pull-request-available
• External issue URL: https://github.com/apache/arrow/issues/20173
• Assignee: Alenka Frim
• Reporter: Alenka Frim
• Created: 29/Mar/22 11:07
• Updated: 11/Jan/23 11:41
• Resolved: 07/Apr/22 10:09

Description

Ensure all docstrings of class Table, the functions and the constructor have an Examples section:

• https://arrow.apache.org/docs/python/generated/pyarrow.Table.html#pyarrow.Table
• https://arrow.apache.org/docs/python/generated/pyarrow.TableGroupBy.html#pyarrow.TableGroupBy
• https://arrow.apache.org/docs/python/generated/pyarrow.table.html#pyarrow.table
• https://arrow.apache.org/docs/python/generated/pyarrow.concat_tables.html#pyarrow.concat_tables 

also https://arrow.apache.org/docs/python/generated/pyarrow.concat_arrays.html#pyarrow.concat_arrays should be amended.

Issue Links

• links to: GitHub Pull Request #12772