[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[jira] [Created] (ARROW-2684) Improve Python documentation

Dominik Moritz created ARROW-2684:

             Summary: Improve Python documentation
                 Key: ARROW-2684
                 URL: https://issues.apache.org/jira/browse/ARROW-2684
             Project: Apache Arrow
          Issue Type: Improvement
          Components: Python
            Reporter: Dominik Moritz

The python documentation is currently not beginner friendly and things like the IPC format are not discoverable. For example, [https://arrow.apache.org/docs/python/ipc.html] has the word "IPC" only in the title. Also, it's currently not clear how to write a file to disk.

I propose that the documentation becomes more of an API docs rather than a set of examples. Examples are valuable but they cannot replace documentation of the inputs and outputs of various functions. 

See [https://github.com/apache/arrow/issues/2119] for more. 

This message was sent by Atlassian JIRA