You are viewing a plain text version of this content. The canonical link for it is here.
Posted to issues@arrow.apache.org by "Joris Van den Bossche (Jira)" <ji...@apache.org> on 2022/11/18 13:32:00 UTC
[jira] [Created] (ARROW-18363) [Docs] Include warning when viewing old contributing docs (redirecting to dev docs)
Joris Van den Bossche created ARROW-18363:
---------------------------------------------
Summary: [Docs] Include warning when viewing old contributing docs (redirecting to dev docs)
Key: ARROW-18363
URL: https://issues.apache.org/jira/browse/ARROW-18363
Project: Apache Arrow
Issue Type: Improvement
Components: Documentation
Reporter: Joris Van den Bossche
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
--
This message was sent by Atlassian Jira
(v8.20.10#820010)