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

Dominik Moritz commented on ARROW-16039:
----------------------------------------

Absolutely. Please understand that we are a small team of volunteers doing what 
we can. I appreciate that you took the time to write up the painpoints here as 
it will help us guide our effort. 

> [JS] Documentation is quite obscure and not useful
> --------------------------------------------------
>
>                 Key: ARROW-16039
>                 URL: https://issues.apache.org/jira/browse/ARROW-16039
>             Project: Apache Arrow
>          Issue Type: Improvement
>          Components: JavaScript
>    Affects Versions: 7.0.0
>         Environment: Linux, Deno, DOM
>            Reporter: Teodor Kostov
>            Priority: Major
>
> I've been looking forward to using Apache Arrow as a data storage component 
> in a frontend application that heavily relies on time series data. However, 
> the syntax seems to have changed quite a lot with version *7.0.0*. Most of 
> the examples on https://observablehq.com seem to be outdated because of that.
> The two main resources https://arrow.apache.org/docs/js/index.html and 
> https://arrow.apache.org/docs/js/modules/Arrow_dom.html are quite 
> insufficient to understand how to use the project. There are a bunch of 
> examples on how to create a table and a vector. However, it seems that the 
> most important use case in JS is not captured - how to create a table from an 
> array of records
> {code:javascript}
> [{a:1, b:2}, {a:3, b:4}]
> {code}
> or how to create a table from an observable that provides one record at a 
> time.
> {code:javascript}
> callback(record => ???)
> {code}
> No information on how to append data to a table (except the _concat()_ 
> method).
> No information on how to manipulate the data in a table or an example on how 
> to consume it beyond the fact that a table is an iterable and has a _get()_ 
> method.
> Please, it will be also quite helpful to add some examples on how to work 
> with time series data.
> Current state of the documentation does not provide the ability for the 
> project to be adopted by anyone else except the core developers.



--
This message was sent by Atlassian Jira
(v8.20.1#820001)

Reply via email to