[
https://issues.apache.org/jira/browse/ARROW-14338?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
]
Ian Cook updated ARROW-14338:
-----------------------------
Description:
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}<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
was:
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 {{<span class="version label label-default"
data-toggle="tooltip" data-placement="bottom" title=""
data-original-title="Released version">6.0.1</span>}} with a <select> that
would allow users to navigate to other versions of the R docs
> [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
> Priority: Major
>
> 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}<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
--
This message was sent by Atlassian Jira
(v8.20.1#820001)
