Better explanation of `append` and `overwrite` in `to_parquet`
Open
- Dominant language
- Python
- Stars
- 89
- Forks
- 26
- PR merge metrics
- No merged PRs in 30d
Description
As mentioned in https://github.com/dask/dask-expr/pull/1051#discussion_r1589112791, I have trouble understanding what the two options do and how they are _not_ the inverse of one another. I suspect users face the same problem.
Contributor guide
Research direction
Start by reading the existing `to_parquet` documentation and the linked discussion in pull request #1051. Clarify what `append` and `overwrite` each do and how they differ, then ensure the documentation explains their relationship clearly.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- python
- Domain
- documentation
- Issue type
- Documentation
- Difficulty
- 2/5
- Estimated time
- 1-3 hours
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 38/100