[ARROW-15139] [Python] write_dataset's file_write_options are too confusing and/or undocumented

• Type: Improvement
• Status: Closed
• Priority: Major
• Resolution: Duplicate
• Component/s: Python
• External issue URL: https://github.com/apache/arrow/issues/30646
• Assignee: Unassigned
• Reporter: Weston Pace
• Created: 16/Dec/21 18:32
• Updated: 11/Jan/23 08:44
• Resolved: 16/Nov/22 19:34

Description

ParquetFileWriteOptions / IpcFileWriteOptions / CsvFileWriteOptions are completely undocumented.

Also, creating them via the format is a little peculiar / confusing and I'm not sure why it is required.

It should be clear to the user what options they can set and how to set them.

Issue Links

• duplicates: ARROW-18346 [Python] Dataset writer API papercuts