[jira] [Commented] (ARROW-14338) [Docs] Add version dropdown to the pkgdown (R) docs

["Nicola Crane (Jira)" <ji...@apache.org>]

    [ https://issues.apache.org/jira/browse/ARROW-14338?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17499746#comment-17499746 ] 

Nicola Crane commented on ARROW-14338:
--------------------------------------

Not just you [~icook], thanks for reporting this.  Have opened ARROW-15819 

> [Docs] Add version dropdown to the pkgdown (R) docs
> ---------------------------------------------------
>
>                 Key: ARROW-14338
>                 URL: https://issues.apache.org/jira/browse/ARROW-14338
>             Project: Apache Arrow
>          Issue Type: Sub-task
>          Components: Documentation, R
>            Reporter: Nicola Crane
>            Assignee: Nicola Crane
>            Priority: Major
>              Labels: pull-request-available
>             Fix For: 7.0.0
>
>          Time Spent: 3h 20m
>  Remaining Estimate: 0h
>
> The Python and C++ documentation have support for serving multiple versions of the docs and switching between them thanks to the newly added version switcher. The same doesn't apply to the R docs as they are not implemented in Sphinx and thus can't benefit from the version switcher implemented for Sphinx.
> We should provide an equivalent version switcher for the R docs.
> We are already hosting multiple versions of the R docs:
>  * Stable: [https://arrow.apache.org/docs/r/]
>  * Dev: [https://arrow.apache.org/docs/dev/r/]
>  * Old releases: [https://arrow.apache.org/docs/5.0/r/] etc.
> So the need is simply for a UI element to enable users to easily navigate between these.
> Relevant pkgdown issue: [https://github.com/r-lib/pkgdown/issues/1373]
> Possible implementation ideas:
>  - [https://insightsengineering.github.io/r.pkg.template/] does it with a dropdown in the main header, I suppose that's something we could do as well (although that would be some manual work to update it in {{_pkgdown.yml}} before each version)
>  - from [~icook]: I don’t have an example of extra.js being used specifically for version switching, but we already have an extra.js we’re using for a different purpose: [https://github.com/apache/arrow/blob/master/r/pkgdown/extra.js]. I believe it would be relatively straightforward to use jQuery to replace the static version {{<span>}} which looks like this
> {code:java}
> <span class="version label label-default" data-toggle="tooltip" data-placement="bottom" title="" data-original-title="Released version">6.0.1</span>{code}
> with a {{<select>}} that would allow users to navigate to other versions of the R docs
> If it is necessary to hard-code R package versions in a file to achieve this, then we could automate the updating of these hard-coded versions at each release through [dev/release/utils-prepare.sh|https://github.com/apache/arrow/blob/master/dev/release/utils-prepare.sh], and add a test confirming the update at [dev/release/01-prepare-test.rb|https://github.com/apache/arrow/blob/master/dev/release/01-prepare-test.rb].



--
This message was sent by Atlassian Jira
(v8.20.1#820001)