[Python] Dataset writer API papercuts

[asfimport]

• Writer options are not very discoverable. Perhaps "file_options" should mention compression as an example of something you can control, so people looking for it know where to go next?
• Compression seems like it might be common enough to warrant a top-level parameter somehow (even if it gets implemented differently internally)?
• Either way, this needs a cookbook example.
• make_write_options is lacking a docstring
• Writer options objects are lacking {}__repr__{}s

Reporter: David Li / @lidavidm

Related issues:

• [Python] write_dataset's file_write_options are too confusing and/or undocumented (is duplicated by)

_{Note: This issue was originally created as ARROW-18346. Please see the migration documentation for further details.}

[thisisnic]

This issue has been marked as stale because it has had no activity in the past 2 years. Please remove the stale label or comment below, or this issue will be closed in 14 days.