[jira] [Created] (ARROW-16039) [JS] Documentation is quite obscure and not useful

["Teodor Kostov (Jira)" <ji...@apache.org>]

Teodor Kostov created ARROW-16039:
-------------------------------------

             Summary: [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


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)