[ https://issues.apache.org/jira/browse/ARROW-16802?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17568156#comment-17568156 ]
Ian Cook commented on ARROW-16802: ---------------------------------- One important consideration: In the future, we intend for Substrait to be the primary "API language" for Acero. We will discourage direct use of the ExecPlan API and encourage developers to use Substrait plans to tell Acero what operations to execute. So we should probably not invest too much energy in documenting the ExecPlan API. > [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 > Assignee: Vibhatha Lakmal Abeykoon > 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)