[CI][R][Docs] Docs jobs failing due to R Markdown error

[AlenkaF]

Describe the bug, including details regarding any error messages, version, and platform.

The docs jobs have started failing with a R Markdown error:

-- RMarkdown error -------------------------------------------------------------

Quitting from lines 192-195 [unnamed-chunk-14] (arrow.Rmd)
Warning message:
The vignette title specified in \VignetteIndexEntry{} is different from the title in the YAML metadata. The former is "", and the latter is "Get started with Arrow". If that is intentional, you may set options(rmarkdown.html_vignette.check_title = FALSE) to suppress this check. 
--------------------------------------------------------------------------------
---
Standard error:
Attaching package: 'arrow'

The following object is masked from 'package:utils':

    timestamp

Warning message:
In process_conditional_examples(x) :
  @examplesIf condition `arrow_with_dataset() && identical(Sys.getenv("NOT_CRAN"), "true")` is FALSE
---
Backtrace:
1. pkgdown::build_site(install = FALSE)
2. pkgdown:::build_site_external(pkg = pkg, examples = examples, run_dont_run = run_d...
3. callr::r(function(..., cli_colors, pkgdown_internet) { ...
4. callr:::get_result(output = out, options)
5. callr:::throw(callr_remote_error(remerr, output), parent = fix_msg(remerr[[3]]))

See:

• https://github.com/ursacomputing/crossbow/actions/runs/7772142018/job/21194228305#step:7:13155
• https://github.com/apache/arrow/actions/runs/7757912390/job/21158451055#step:7:13833

@assignUser @paleolimbot do you have any insights into what should be updated/fixed?

cc @kou

Component(s)

Continuous Integration, R

[jorisvandenbossche]

FWIW I assume it's not related to the preview, it's just the doc build in general that is failing? (also on the main branch, the last commits have red CI for docs)

[AlenkaF]

Yes, true! Changed the description and title.

[kou]

Quitting from lines 192-195 [unnamed-chunk-14] (arrow.Rmd)

https://github.com/apache/arrow/blob/ed78986aa6971484f40a5780922128636a47d175/r/vignettes/arrow.Rmd#L192-L195

This error happen since 2024-02-01: https://github.com/apache/arrow/actions/runs/7742113156/job/21110485230

reticulate 1.35.0 released on 2024-02-01: https://github.com/rstudio/reticulate/releases/tag/v1.35.0

It seems that reticulate 1.35.0 is related. https://github.com/apache/arrow/issues/39933 may be caused by the same problem.

[paleolimbot]

I can take a stab at fixing this...it looks like they updated how Python capsules and R external pointers are converted. Basically, I think we need to use strings instead of capsules but my memory of rewriting that is fuzzy.