[ 
https://issues.apache.org/jira/browse/ARROW-2684?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
 ]

Rok Mihevc updated ARROW-2684:
------------------------------
    External issue URL: https://github.com/apache/arrow/issues/15729

> [Python] Various documentation improvements
> -------------------------------------------
>
>                 Key: ARROW-2684
>                 URL: https://issues.apache.org/jira/browse/ARROW-2684
>             Project: Apache Arrow
>          Issue Type: Improvement
>          Components: Python
>            Reporter: Dominik Moritz
>            Assignee: Antoine Pitrou
>            Priority: Major
>             Fix For: 0.12.0
>
>
> 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
(v8.20.10#820010)

Reply via email to