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)