You are viewing a plain text version of this content. The canonical link for it is here.
Posted to issues@arrow.apache.org by "Antoine Pitrou (Jira)" <ji...@apache.org> on 2019/09/18 17:13:00 UTC

[jira] [Updated] (ARROW-2939) [Python] Provide links to documentation pages for old versions

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

Antoine Pitrou updated ARROW-2939:
----------------------------------
    Component/s: Documentation

> [Python] Provide links to documentation pages for old versions
> --------------------------------------------------------------
>
>                 Key: ARROW-2939
>                 URL: https://issues.apache.org/jira/browse/ARROW-2939
>             Project: Apache Arrow
>          Issue Type: Improvement
>          Components: Documentation, Python
>            Reporter: Ian Robertson
>            Priority: Minor
>              Labels: documentation
>
> Hey folks, apologies if this isn't the right place to raise this.  In poking around the web documentation (for pyarrow specifically), it looks like the auto-generated API docs contain commits past the release of 0.9.0.  For example:
>  * [https://arrow.apache.org/docs/python/generated/pyarrow.Table.html#pyarrow.Table.column]
>  * Contains differences merged here: [https://github.com/apache/arrow/pull/1923]
>  * But latest pypi/conda versions of pyarrow are 0.9.0, which don't include that change.
> Not sure if the docs are auto-built off master somewhere, I couldn't find anything about building docs in the docs itself.  I would guess that you may want some of the usage docs to be published in between releases if they're not about new functionality, but the API reference being out of date can be confusing.  Is it possible to anchor the API docs to the latest released version?  Or even something like how Pandas has a whole bunch of old versions still available? (e.g. [https://pandas.pydata.org/pandas-docs/stable/] vs. old versions like [http://pandas.pydata.org/pandas-docs/version/0.17.0/])



--
This message was sent by Atlassian Jira
(v8.3.4#803005)