Skip to content

docs(NEWS): align renv_paths_cache bullet with post-#106 default - #108

Merged
VincentGuyader merged 1 commit into
masterfrom
docs/news-renv-paths-cache-bullet
May 6, 2026
Merged

docs(NEWS): align renv_paths_cache bullet with post-#106 default#108
VincentGuyader merged 1 commit into
masterfrom
docs/news-renv-paths-cache-bullet

Conversation

@VincentGuyader

Copy link
Copy Markdown
Member

Summary

The NEWS bullet for the renv_paths_cache parameter (added in
0.3.0) still described the pre-#106 behaviour:

dock_from_renv() gains a renv_paths_cache parameter (default
/root/.cache/R/renv)...

After #106 landed, the signature default flipped from a literal
string to NULL with auto-derivation from user:

  • user = NULL -> /root/.cache/R/renv (legacy).
  • user = "<name>" (default "rstudio") -> /home/<name>/.cache/R/renv.

This PR rewrites the NEWS bullet to document the auto-derive
contract verbatim, closing the doc-runtime drift introduced when
#106 was merged.

Test plan

  • No code, NAMESPACE, Rd, or test change. Diff = single bullet
    rewrite in NEWS.md.
  • Cross-checked the rewritten bullet against R/dock_from_renv.R
    signature (line 139), auto-derive branch (lines 160-166),
    ARG/ENV emission (line 194), and cache mount target (line 367)
    via pr-reviewer agent.
  • No em/en-dashes; style matches surrounding "New features"
    bullets.

Context

Surfaced during the post-merge sanity check on master 0.3.0.
Tier-zero polish before the CRAN release sequence.

The renv_paths_cache bullet still described the pre-#106 behaviour
(default = "/root/.cache/R/renv"). After #106, the signature default
is NULL with auto-derivation from `user`: /root for user = NULL,
/home/<user> otherwise. Update the bullet to reflect the actual
runtime, closing the doc-runtime drift introduced by the merge.

No code change. No NAMESPACE / Rd impact.

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR updates the dockerfiler 0.3.0 NEWS entry for dock_from_renv()’s renv_paths_cache parameter so the documented default matches the current runtime behavior introduced in #106 (auto-derivation from user when renv_paths_cache = NULL).

Changes:

  • Rewrite the NEWS bullet for renv_paths_cache to document NULL-default auto-derivation from user.
  • Clarify that renv_paths_cache drives the RENV_PATHS_CACHE build-arg default, propagated ENV, and cache mount target.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@VincentGuyader
VincentGuyader merged commit 35cc05d into master May 6, 2026
10 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants