[GitHub] [arrow] jorisvandenbossche commented on pull request #34894: GH-34868: [Python] Share docstrings between classes

["jorisvandenbossche (via GitHub)" <gi...@apache.org>]

jorisvandenbossche commented on PR #34894:
URL: https://github.com/apache/arrow/pull/34894#issuecomment-1499114897

   >  Do we know if there are other places in pyarrow that would benefit from it?
   
   I am not sure we have many places that currently are not in cython, and have repetition in docstrings. Looking through our python files, we do already have some manual templating in parquet/core.py, ipc.py or orc.py (eg to share the explanation of certain parameters between multiple docstrings), but I don't know if they would fit this pattern for using `@doc`.
   
   `pyarrow.filesystem` is also deprecated, so that will be removed in a few releases (not that we can't improve the docs with this PR in the meantime). `types.py` indeed looks like the main obvious candidate where this could be useful.


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: github-unsubscribe@arrow.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org