[
https://issues.apache.org/jira/browse/ARROW-14338?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
]
Krisztian Szucs updated ARROW-14338:
------------------------------------
Fix Version/s: 7.0.0
> [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: 40m
> 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/01-prepare.sh|https://github.com/ianmcook/arrow/blob/master/dev/release/01-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)
