[ARROW-16802] [Docs] Improve Acero Documentation

• Type: Improvement
• Status: Open
• Priority: Major
• Resolution: Unresolved
• Component/s: Documentation
• External issue URL: https://github.com/apache/arrow/issues/20284
• Assignee: Unassigned
• Reporter: Will Jones
• Created: 09/Jun/22 20:23
• Updated: 11/Jan/23 11:46

Description

From amol- :

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.

Issue Links

• blocks: ARROW-16632 [Website] Announce Acero Engine
• is related to: ARROW-17177 [C++][Docs] Re-Organize the Existing Acero Streaming Engine Documentation