Skip to content

CRAN prep: DESCRIPTION, NEWS, cran-comments, CITATION#62

Merged
pearsonca merged 9 commits into
mainfrom
issue-31-cran-prep
May 29, 2026
Merged

CRAN prep: DESCRIPTION, NEWS, cran-comments, CITATION#62
pearsonca merged 9 commits into
mainfrom
issue-31-cran-prep

Conversation

@WestonVoglesonger
Copy link
Copy Markdown
Contributor

@WestonVoglesonger WestonVoglesonger commented May 23, 2026

PR A of #31's plan. Adds the metadata files needed for first CRAN submission. Touches only DESCRIPTION, 3 new top-level files, and .Rbuildignore.

  • DESCRIPTION: replaces boilerplate Description: with a real summary; bumps Version: to 0.1.0 (per Carl's "conventional" call on Submit to CRAN #31).
  • NEWS.md (new): initial # imuGAP 0.1.0 entry enumerating the exported surface.
  • cran-comments.md (new): first-submission template with [bracketed placeholders] for Claire to fill in package-specific content (per Carl: "draft please, then let's have @csmith701 do detailed content").
  • CITATION.cff (new): CFF 1.2.0; Carl + Claire as authors with ORCIDs. ctb contributors omitted (easy to add if you prefer).
  • .Rbuildignore: adds cran-comments.md + CITATION.cff; intentionally does NOT add NEWS.md (belongs in the tarball per CRAN convention).

Verified R CMD build . succeeds and produces imuGAP_0.1.0.tar.gz containing NEWS.md but not cran-comments.md / CITATION.cff.

@pearsonca: please confirm the Description: wording + version bump.
@csmith701: please fill in cran-comments.md placeholders before we tag the release.

Refs #31.

- DESCRIPTION: replace placeholder Description with real package
  summary covering the Bayesian hierarchical coverage model, B-spline
  smoothed cohort effects, optional county/school random effects, and
  Stan/rstan implementation. Bump version from 0.0.0.9000 to 0.1.0.
- NEWS.md (new): initial release entry enumerating exported functions
  (sampling, predict.imugap_fit, extract_imugap, canonicalize_*,
  imugap_options, stan_options), bundled Stan models (stateonly + v6),
  bundled datasets (locations_sim, observations_sim, populations_sim,
  fit_sim), and the pkgdown site.
- cran-comments.md (new): first-submission template with placeholders
  for @csmith701 to fill in package-specific notes before release.
- CITATION.cff (new): CFF 1.2.0 metadata file with Carl Pearson (cre)
  and Claire Perrin Smith (aut) as the cited authors, MIT license,
  v0.1.0, and repository/URL pointing at the GitHub repo and pkgdown
  site so Zenodo can pick it up on release.
- .Rbuildignore: ignore cran-comments.md and CITATION.cff (NEWS.md is
  intentionally NOT ignored so it ships in the source tarball per
  CRAN convention).

Verified locally with R CMD build .: succeeds and produces
imuGAP_0.1.0.tar.gz containing NEWS.md but neither cran-comments.md
nor CITATION.cff.

Refs #31.
@codecov
Copy link
Copy Markdown

codecov Bot commented May 23, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

Comment thread CITATION.cff Outdated
Comment thread CITATION.cff Outdated
Comment thread cran-comments.md
Comment on lines +40 to +42
- Bundled example datasets (`locations_sim`, `observations_sim`,
`populations_sim`, `fit_sim`) are simulated and small; `fit_sim` is a
wiring fixture for examples and tests, not a converged posterior.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Note that we will update this when we update the package data to reflect new prediction capabilities.

Comment thread cran-comments.md Outdated
Comment thread cran-comments.md Outdated
Comment thread cran-comments.md Outdated
Comment thread DESCRIPTION Outdated
Comment thread DESCRIPTION Outdated
Copy link
Copy Markdown
Contributor

@csmith701 csmith701 left a comment

Choose a reason for hiding this comment

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

Approved pending suggested changes

Comment thread NEWS.md Outdated
Comment thread NEWS.md
Comment on lines +24 to +26
- Bundled example datasets for end-to-end examples and tests:
`locations_sim`, `observations_sim`, `populations_sim`, and the
reference `fit_sim` `stanfit` fixture.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

To be updated when I update package data

pearsonca and others added 8 commits May 29, 2026 13:07
Co-authored-by: Claire P. Smith <63207423+csmith701@users.noreply.github.com>
Co-authored-by: Claire P. Smith <63207423+csmith701@users.noreply.github.com>
Co-authored-by: Claire P. Smith <63207423+csmith701@users.noreply.github.com>
Co-authored-by: Claire P. Smith <63207423+csmith701@users.noreply.github.com>
Co-authored-by: Claire P. Smith <63207423+csmith701@users.noreply.github.com>
Co-authored-by: Claire P. Smith <63207423+csmith701@users.noreply.github.com>
Co-authored-by: Claire P. Smith <63207423+csmith701@users.noreply.github.com>
Co-authored-by: Claire P. Smith <63207423+csmith701@users.noreply.github.com>
@pearsonca
Copy link
Copy Markdown
Member

@WestonVoglesonger good for now; @csmith701 and I will do some more triage when resolving the package data update, per the comments, and then may request a clean up pass.

@pearsonca pearsonca merged commit e5b4ff6 into main May 29, 2026
12 checks passed
@pearsonca pearsonca deleted the issue-31-cran-prep branch May 30, 2026 17:52
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.

3 participants