You are viewing a plain text version of this content. The canonical link for it is here.
Posted to jira@arrow.apache.org by "Nicola Crane (Jira)" <ji...@apache.org> on 2022/11/23 13:27:00 UTC
[jira] [Updated] (ARROW-18393) [Docs][R] Include warning when viewing old docs (redirecting to stable docs)
[ https://issues.apache.org/jira/browse/ARROW-18393?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Nicola Crane updated ARROW-18393:
---------------------------------
Labels: (was: pull-request-available)
> [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
> Priority: Major
>
> 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)