[ARROW-2939] [Python] Provide links to documentation pages for old versions

• Type: Improvement
• Status: Closed
• Priority: Minor
• Resolution: Duplicate
• Component/s: Documentation, Python
• Labels: documentation
• External issue URL: https://github.com/apache/arrow/issues/19306
• Assignee: Unassigned
• Reporter: Ian Robertson
• Created: 30/Jul/18 17:38
• Updated: 11/Jan/23 07:24
• Resolved: 01/Oct/21 08:14

Description

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

Issue Links

• is a clone of: ARROW-13260 [Doc] Host different released versions of the documentation + version switcher