[ARROW-18363] [Docs] Include warning when viewing old docs (redirecting to stable/dev docs)

• Type: Improvement
• Status: Resolved
• Priority: Major
• Resolution: Fixed
• Fix Version/s: 11.0.0
• Component/s: Documentation
• Labels: pull-request-available
• External issue URL: https://github.com/apache/arrow/issues/33531
• Assignee: Alenka Frim
• Reporter: Joris Van den Bossche
• Created: 18/Nov/22 13:31
• Updated: 11/Jan/23 11:59
• Resolved: 23/Dec/22 08:46

Description

Now we have versioned docs, we also have the old versions of the developers docs (eg https://arrow.apache.org/docs/9.0/developers/guide/communication.html). Those might be outdated (eg regarding communication channels, build instructions, etc), and typically when contributing / developing with the latest arrow, one should always check the latest dev version of the contributing docs.

We could add a warning box pointing this out and linking to the dev docs.

For example similarly how some projects warn about viewing old docs in general and point to the stable docs (eg https://mne.tools/1.1/index.html or https://scikit-learn.org/1.0/user_guide.html). In this case we could have a custom box when at a page in /developers to point to the dev docs instead of stable docs

Issue Links

• is cloned by: ARROW-18393 [Docs][R] Include warning when viewing old docs (redirecting to stable docs)
• links to: GitHub Pull Request #14687
• links to: GitHub Pull Request #14839