[jira] [Comment Edited] (ARROW-16802) [Docs] Improve Acero Documentation

["Kexin Su (Jira)" <ji...@apache.org>]

    [ https://issues.apache.org/jira/browse/ARROW-16802?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17567908#comment-17567908 ] 

Kexin Su edited comment on ARROW-16802 at 7/18/22 9:48 AM:
-----------------------------------------------------------

Hi, I am doing an (academic) project about using GPU to accelerate Acero, however, I find it very hard to start with it, because there is literally only this page talking about Acero  [https://arrow.apache.org/docs/cpp/streaming_execution.html.|https://arrow.apache.org/docs/cpp/streaming_execution.html]

To understand things I have to look into the code and easily get lost. 

So I am very looking forward to more detailed documentation or design doc, or maybe a specific communication channel for Acero if possible?

To be honest, I am even in trouble with beginning to Debug with Acero, because there are no such CMake Presets or any instructions on how to do that.

Any reply will be highly appreciated! Thanks in advance!


was (Author: JIRAUSER292919):
Hi, I am doing an (academic) project about using GPU to accelerate Acero, however, I find it very hard to start with it, because there is literally only this page talking about Acero  [https://arrow.apache.org/docs/cpp/streaming_execution.html.|https://arrow.apache.org/docs/cpp/streaming_execution.html]

To understand things I have looked into the code and easily get lost. 

So I am very looking forward to more detailed documentation or design doc, or maybe a specific communication channel for Acero if possible?

To be honest, I am even in trouble with beginning to Debug with Acero, because there are no such CMake Presets or any instructions on how to do that.

Any reply will be highly appreciated! Thanks in advance!

> [Docs] Improve Acero Documentation
> ----------------------------------
>
>                 Key: ARROW-16802
>                 URL: https://issues.apache.org/jira/browse/ARROW-16802
>             Project: Apache Arrow
>          Issue Type: Improvement
>          Components: Documentation
>            Reporter: Will Jones
>            Priority: Major
>
> From [~amol-] :
> {quote}If we want to start promoting Acero to the world, I think we should work on improving a bit the documentation first. Having a blog post that then redirects people to a docs that they find hard to read/apply might actually be counterproductive as it might create a fame of being badly documented.
> At the moment the only mention of it is [https://arrow.apache.org/docs/cpp/streaming_execution.html] and it's not very easy to follow (not much explainations, just blocks of code). In comparison if you look at the compute chapter in Python ( [https://arrow.apache.org/docs/dev/python/compute.html] ) it's much more talkative and explains things as it goes.
> {quote}



--
This message was sent by Atlassian Jira
(v8.20.10#820010)