You are viewing a plain text version of this content. The canonical link for it is here.
Posted to issues@arrow.apache.org by "Nicola Crane (Jira)" <ji...@apache.org> on 2022/11/23 13:27:00 UTC

[jira] [Created] (ARROW-18393) [Docs][R] Include warning when viewing old docs (redirecting to stable docs)

Nicola Crane created ARROW-18393:
------------------------------------

             Summary: [Docs][R] Include warning when viewing old docs (redirecting to stable docs)
                 Key: ARROW-18393
                 URL: https://issues.apache.org/jira/browse/ARROW-18393
             Project: Apache Arrow
          Issue Type: Improvement
          Components: Documentation
            Reporter: Joris Van den Bossche
            Assignee: Alenka Frim


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)