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

Will Jones commented on ARROW-16802:
------------------------------------

I agree with Alessandro we should improve our docs before the blog post. 
Ideally we do both soon.

> [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.7#820007)

Reply via email to