From b06482bcfb358e4f2c15c59e6b6957984e2f1a17 Mon Sep 17 00:00:00 2001 From: Edgar Ruiz <77294576+edgararuiz@users.noreply.github.com> Date: Wed, 10 Jun 2026 13:08:12 -0500 Subject: [PATCH 1/3] Starts preparing release --- .claude/CLAUDE.md | 62 +++++++++++++++++++++++++++++++++++++++++++++++ DESCRIPTION | 2 +- NEWS.md | 2 +- cran-comments.md | 38 ++++++++++++++++++----------- 4 files changed, 88 insertions(+), 16 deletions(-) diff --git a/.claude/CLAUDE.md b/.claude/CLAUDE.md index 0c1b25f..a61155c 100644 --- a/.claude/CLAUDE.md +++ b/.claude/CLAUDE.md @@ -91,3 +91,65 @@ Work paragraph by paragraph, always starting by making a TODO list that includes Fix spelling, grammar, and other minor problems without asking the user. Label any unclear, confusing, or ambiguous sentences with a FIXME comment. Only report what you have changed. + + +## Release process + +### 1. Update local R packages +Before starting, make sure all local packages are up to date to avoid masking +failures that will show up in CI: +```r +update.packages(ask = FALSE) +``` + +### 2. Run local tests and R CMD check +Confirm the package is in a green state before making any release changes: +```r +devtools::test() +devtools::check() +``` +`devtools::test()` gives faster feedback on failures. `devtools::check()` must +be `0 errors | 0 warnings | 0 notes` before submitting to CRAN. + +### 3. Update version in DESCRIPTION + +Remove the dev version number, bump the remaining number, usually by the minor +version, unless there are a lot of significant changes + +### 4. Submit to win-builder +```r +devtools::check_win_devel() +``` +Address any new NOTEs/WARNINGs. + +### 5. Prepare cran-comments.md + +Populate the three sections using: + +- **R CMD checks on GitHub**: `cranjobs::github_action_run("R-CMD-check.yaml")` +- **R CMD check results**: from `devtools::check()` above + +Template: +```markdown +## Submission + +- + +## R CMD checks on GitHub + +- + +## R CMD check results + +0 errors ✔ | 0 warnings ✔ | 0 notes ✔ +``` + +### 6. Submit to CRAN +```r +devtools::submit_cran() +``` + +## Common issues to watch for + +- **Undocumented exported functions**: add a roxygen title + `@keywords internal` to stub methods +- **Broken URLs in docs**: R CMD check on win-builder validates URLs; fix dead links before submission diff --git a/DESCRIPTION b/DESCRIPTION index af8f146..ac4bf78 100644 --- a/DESCRIPTION +++ b/DESCRIPTION @@ -1,6 +1,6 @@ Package: lang Title: Translates R Help Documentation using Large Language Models -Version: 0.1.1.9000 +Version: 0.1.2 Authors@R: c( person("Edgar", "Ruiz", , "edgar@posit.co", role = c("aut", "cre")), person("Posit Software, PBC", role = c("cph", "fnd"), diff --git a/NEWS.md b/NEWS.md index 4b77a2e..ddc957e 100644 --- a/NEWS.md +++ b/NEWS.md @@ -1,4 +1,4 @@ -# lang 0.1.1.9000 +# lang 0.1.2 ## Bug fixes diff --git a/cran-comments.md b/cran-comments.md index cd21d79..16b03b1 100644 --- a/cran-comments.md +++ b/cran-comments.md @@ -1,23 +1,33 @@ -## Resubmission +## Submission -- Replaced `\donttest{}` examples with `\dontrun{}` and added comments - explaining they require an interactive session with a local LLM provider. - This implements the suggestion by Uwe Ligges. +We recognize this resubmission comes sooner than the usual one-month waiting +period following our previous release (0.1.1). We are submitting early because +the bug fixed in this version is user-visible and significant enough that it +has a high probability of discouraging adoption of the package. -- This is a new package +The issue stems from an inherent unpredictability in local LLMs: when the +context summary injected into the translation prompt is much longer than the +field being translated, some local models paraphrase the context rather than +translate the input. For short fields (10 words or fewer) this happened +consistently, producing output that was clearly wrong and immediately apparent +to users. There was no workaround available to users short of disabling context +summaries entirely, a feature that was the main addition in 0.1.1. -- Description: Use an 'LLM' to translate a function's help documentation on the fly. -It overrides the `?` and `help()` functions in your R session. If you are -using 'RStudio' or 'Positron', the translated help page will appear in the usual -'Help' pane. +We apologize for the rapid turnaround and appreciate CRAN's consideration. + +- When the input is 10 words or fewer, the context summary is now omitted from + the translation prompt. Local LLMs can get confused by a context summary that + is much longer than the field being translated, causing them to paraphrase + the context instead of translating the input. ## R CMD checks on GitHub -- Ubuntu 24.04.3 LTS (x86_64, linux-gnu), R version 4.5.1 (2025-06-13) -- Ubuntu 24.04.3 LTS (x86_64, linux-gnu), R version 4.4.3 (2025-02-28) -- Ubuntu 24.04.3 LTS (x86_64, linux-gnu), R Under development (unstable) (2025-10-18 r88943) -- macOS Sequoia 15.6.1 (aarch64, darwin20), R version 4.5.1 (2025-06-13) -- Windows Server 2022 x64 (build 26100) (x86_64, mingw32), R version 4.5.1 (2025-06-13 ucrt) +- Windows Server x64 (build 26100) (x86_64, mingw32), R version 4.2.3 (2023-03-15 ucrt) +- Ubuntu 24.04.4 LTS (x86_64, linux-gnu), R Under development (unstable) (2026-06-06 r90114) +- Windows Server 2022 x64 (build 26100) (x86_64, mingw32), R version 4.6.0 (2026-04-24 ucrt) +- Ubuntu 24.04.4 LTS (x86_64, linux-gnu), R version 4.5.3 (2026-03-11) +- macOS Sequoia 15.7.7 (aarch64, darwin23), R version 4.6.0 (2026-04-24) +- Ubuntu 24.04.4 LTS (x86_64, linux-gnu), R version 4.6.0 (2026-04-24) ## R CMD check results From be70d834dc1c905c97943de35b08ad1f7d3983f8 Mon Sep 17 00:00:00 2001 From: Edgar Ruiz <77294576+edgararuiz@users.noreply.github.com> Date: Wed, 10 Jun 2026 13:26:35 -0500 Subject: [PATCH 2/3] Adds ackowledgement of the NOTE in cran comments --- cran-comments.md | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/cran-comments.md b/cran-comments.md index 16b03b1..bdb78db 100644 --- a/cran-comments.md +++ b/cran-comments.md @@ -13,7 +13,12 @@ consistently, producing output that was clearly wrong and immediately apparent to users. There was no workaround available to users short of disabling context summaries entirely, a feature that was the main addition in 0.1.1. -We apologize for the rapid turnaround and appreciate CRAN's consideration. +We are aware that the win-builder check flags a NOTE for "Days since last +update: 5", which is a direct consequence of this early resubmission and the +very reason for this explanatory note. We apologize for the rapid turnaround +and appreciate CRAN's consideration. + +### Bug fixes - When the input is 10 words or fewer, the context summary is now omitted from the translation prompt. Local LLMs can get confused by a context summary that From b8c2fa5c1858b476d853be52c68d7702d17bc249 Mon Sep 17 00:00:00 2001 From: Edgar Ruiz <77294576+edgararuiz@users.noreply.github.com> Date: Wed, 10 Jun 2026 13:29:45 -0500 Subject: [PATCH 3/3] Adds win builder results --- cran-comments.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/cran-comments.md b/cran-comments.md index bdb78db..fd31dfb 100644 --- a/cran-comments.md +++ b/cran-comments.md @@ -36,4 +36,10 @@ and appreciate CRAN's consideration. ## R CMD check results +### Local + 0 errors ✔ | 0 warnings ✔ | 0 notes ✔ + +### win-builder + +0 errors ✔ | 0 warnings ✔ | 1 note ✖ (Days since last update: 5 — addressed in submission note above)