[ARROW-8063] [Python] Add user guide documentation for Datasets API

• Type: Improvement
• Status: Resolved
• Priority: Major
• Resolution: Fixed
• Fix Version/s: 0.17.0
• Component/s: Documentation, Python
• Labels: documentation parquet pull-request-available
• External issue URL: https://github.com/apache/arrow/issues/24276
• Assignee: Joris Van den Bossche
• Reporter: Joris Van den Bossche
• Created: 10/Mar/20 18:24
• Updated: 11/Jan/23 07:57
• Resolved: 14/Apr/20 23:01

Description

Currently, we only have API docs (https://arrow.apache.org/docs/python/api/dataset.html), but we also need prose docs explaining what the dataset module does with examples.

This can also include guidelines on how to use this instead of the ParquetDataset API (depending on how we end up doing ARROW-8039), this aspect is also covered by ARROW-8047

Issue Links

• relates to: ARROW-8047 [Python][Documentation] Document migration from ParquetDataset to pyarrow.datasets
• links to: GitHub Pull Request #6779