[
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)