You are viewing a plain text version of this content. The canonical link for it is here.
Posted to github@arrow.apache.org by GitBox <gi...@apache.org> on 2022/07/10 12:34:04 UTC
[GitHub] [arrow-datafusion] kmitchener opened a new issue, #2866: [Question] interested in helping with documentation
kmitchener opened a new issue, #2866:
URL: https://github.com/apache/arrow-datafusion/issues/2866
Hi all,
I want to help with the documentation and I can pull issues from here to work on, but I have questions about how docs should be organized for the python project.
Datafusion-python is now in datafusion-contrib, outside of Apache. However, it's documentation is in the datafusion project repo. This leads to a weird dependency where docs will be created in the main datafusion repo, for versions of the python project managed by datafusion-contrib/datafusion-python. For example, there's already a mismatch between datafusion's [python doc](https://github.com/apache/arrow-datafusion/blob/master/docs/source/python/index.rst) and the same documentation in the datafusion-python repo ([readme](https://github.com/datafusion-contrib/datafusion-python/blob/main/README.md))
It would be better if the docs for the datafusion-python project could be managed and published from that project, for consistency and ease of updating and possibly versioning of the docs in the future. Do you agree? Any ideas how to accomplish that? I'm willing to put in the work if there's agreement how to proceed.
--
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.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
[GitHub] [arrow-datafusion] andygrove commented on issue #2866: [Question] interested in helping with documentation
Posted by GitBox <gi...@apache.org>.
andygrove commented on issue #2866:
URL: https://github.com/apache/arrow-datafusion/issues/2866#issuecomment-1181170972
Thanks for raising this @kmitchener. The docs for the Python bindings should absolutely be in the repo that contains the python bindings and not in the core datafusion crate.
This can be accomplished by creating a PR to add the docs in `datafusion-python` and another PR to remove them from `arrow-datafusion`.
--
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
[GitHub] [arrow-datafusion] alamb closed issue #2866: [Question] interested in helping with documentation
Posted by GitBox <gi...@apache.org>.
alamb closed issue #2866: [Question] interested in helping with documentation
URL: https://github.com/apache/arrow-datafusion/issues/2866
--
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