From 9eda3be59426dbd3d5743c1ba355b943cbc0fcb4 Mon Sep 17 00:00:00 2001 From: "Joshua Uhalt, Ph.D." Date: Mon, 28 Sep 2026 13:40:39 -0400 Subject: [PATCH] Release contentvalidR 0.10.0 Stamps the version, release notes, citation metadata, README, and roadmap for the tenth public release, the last planned before the joint 1.0 release candidate on 2026-10-17. It adds figures for papers, posters, and teaching: content_evidence() with its item flow diagram and item evidence profile, the rating-distribution view, and the apa switch (#82). It also states the handoff contract nomologR reads (#79), makes this package's walkthrough the joint one (#80, #81), separates the Delphi printout's caveats from its teaching (#78), and records the release-candidate timeline (#83). No computed value changes: 25 analyses across every workflow return the same values as v0.9.0. No breaking changes: the plot methods gain arguments after their existing ones. agreement_summary() remains deprecated and is removed in 1.0.0. contentvalidR 0.4.0 has been on CRAN since 2026-09-28. CRAN asks for updates no more often than every one to two months, so 0.10.0 is released on GitHub and R-universe only. Co-Authored-By: Claude Opus 5.5 --- CITATION.cff | 4 ++-- DESCRIPTION | 2 +- NEWS.md | 48 ++++++++++++++++++++++++++++++++++++------------ README.Rmd | 2 +- README.md | 2 +- ROADMAP.md | 31 +++++++++++++++++++++++++++++++ 6 files changed, 72 insertions(+), 17 deletions(-) diff --git a/CITATION.cff b/CITATION.cff index c3b4d02..feeed28 100644 --- a/CITATION.cff +++ b/CITATION.cff @@ -5,8 +5,8 @@ type: software authors: - family-names: Uhalt given-names: Joshua -version: 0.9.0 -date-released: 2026-09-27 +version: 0.10.0 +date-released: 2026-09-28 repository-code: "https://github.com/JUhalt/contentvalidR" url: "https://juhalt.github.io/contentvalidR/" license: GPL-3.0-only diff --git a/DESCRIPTION b/DESCRIPTION index c6c45b3..c6dd0e8 100644 --- a/DESCRIPTION +++ b/DESCRIPTION @@ -1,7 +1,7 @@ Package: contentvalidR Type: Package Title: Tools for Substantive and Content Validity Pretesting -Version: 0.9.0.9000 +Version: 0.10.0 Authors@R: c( person(given = "Joshua", family = "Uhalt", email = "Josh.Uhalt@gmail.com", role = c("aut", "cre")) diff --git a/NEWS.md b/NEWS.md index 61433f2..1c7d523 100644 --- a/NEWS.md +++ b/NEWS.md @@ -1,17 +1,36 @@ -# contentvalidR 0.9.0.9000 (development version) +# contentvalidR 0.10.0 -## On CRAN +Tenth public release, and the last planned before the joint 1.0 release +candidate on 2026-10-17. v0.10.0 adds figures for papers, posters, and +teaching: the item flow diagram and the item evidence profile of +`content_evidence()`, and the full distribution of a panel's ratings, each in +APA gray or in color. It also states the handoff contract nomologR reads, makes +this package's walkthrough the joint one, and separates the Delphi printout's +caveats from its teaching. -* **contentvalidR 0.4.0 was published on CRAN on 2026-09-28.** The README now - gives `install.packages("contentvalidR")` first, carries a CRAN badge, and - explains why CRAN's version can trail the newest release on R-universe: - CRAN asks packages to update no more than every one to two months. +contentvalidR is on CRAN: 0.4.0 was published there on 2026-09-28. CRAN asks +for updates no more often than every one to two months, so 0.10.0 is released +on GitHub and R-universe, and the next CRAN submission is the joint 1.0. + +The package continues to declare `Imports: stats` only. + +**No computed value changes.** Across 25 analyses spanning every workflow, +every value 0.9.0 returns is identical in 0.10.0. Relevance fits gain +`details$ratings`. Some printed wording changes: the Delphi printout's method +paragraphs move into its key, `anova_content()` prints within 80 columns, the +printed handoff advises passing the whole handoff to nomologR, and the +`citation` a handoff carries for `stability = "percent_change"` reads +"Scheibe et al. (1975/2002)". -## Figures for papers, posters, and teaching (in development) +**No breaking changes.** The plot methods gain arguments after their existing +ones: `type`, `apa`, and `labels` for expert-panel fits, and +`which = "distribution"`, `apa`, and `labels` for Delphi fits. +`agreement_summary()` remains deprecated and is removed in 1.0.0. -No computed value changes. Each new figure draws what the fits and handoffs -already decided, and says whether it follows a published form or is this -package's own design. +## Figures for papers, posters, and teaching + +Each new figure draws what the fits and handoffs already decided, and says +whether it follows a published form or is this package's own design. * **`content_evidence()` (new)** brings the handoffs from several review stages together, such as a relevance panel and then an item sort. It prints @@ -47,9 +66,14 @@ package's own design. back travel with the items. The vignette no longer calls the handoff reader in nomologR future work. -## Finishing touches before 1.0 (in development) +## On CRAN -No computed value changes. +* **contentvalidR 0.4.0 was published on CRAN on 2026-09-28.** The README now + gives `install.packages("contentvalidR")` first, carries a CRAN badge, and + explains why CRAN's version can trail the newest release on R-universe: + CRAN asks packages to update no more than every one to two months. + +## Finishing touches before 1.0 * **The Delphi printout separates what changes a reading from what teaches it.** Two short caveats always print: read kappa as a trend beside the diff --git a/README.Rmd b/README.Rmd index e69f340..6590f7e 100644 --- a/README.Rmd +++ b/README.Rmd @@ -26,7 +26,7 @@ if (!requireNamespace("contentvalidR", quietly = TRUE)) { [![Lifecycle: experimental](https://img.shields.io/badge/lifecycle-experimental-orange.svg)](https://lifecycle.r-lib.org/articles/stages.html) -**Current stable release: 0.9.0** (on R-universe; CRAN has 0.4.0, see +**Current stable release: 0.10.0** (on R-universe; CRAN has 0.4.0, see [Installation](#installation)). Development plans: [Roadmap](https://github.com/JUhalt/contentvalidR/blob/master/ROADMAP.md) · [Future research](https://github.com/JUhalt/contentvalidR/milestone/3) · [Open issues](https://github.com/JUhalt/contentvalidR/issues). diff --git a/README.md b/README.md index 0f39a83..c46cdf5 100644 --- a/README.md +++ b/README.md @@ -14,7 +14,7 @@ only](https://img.shields.io/badge/License-GPL--3.0--only-blue.svg)](https://git experimental](https://img.shields.io/badge/lifecycle-experimental-orange.svg)](https://lifecycle.r-lib.org/articles/stages.html) -**Current stable release: 0.9.0** (on R-universe; CRAN has 0.4.0, see +**Current stable release: 0.10.0** (on R-universe; CRAN has 0.4.0, see [Installation](#installation)). Development plans: diff --git a/ROADMAP.md b/ROADMAP.md index 540e8f8..b6fe70b 100644 --- a/ROADMAP.md +++ b/ROADMAP.md @@ -779,6 +779,37 @@ tag. *** +## v0.10.0 - Figures for papers, posters, and teaching + +**Status:** Released (0.10.0 on 2026-09-28, on GitHub and R-universe) +**Version:** `0.10.0` + +Work: [#78](https://github.com/JUhalt/contentvalidR/pull/78) to +[#83](https://github.com/JUhalt/contentvalidR/pull/83). The last release +planned before the joint 1.0 release candidate. + +- [x] Separate the Delphi printout's caveats from its teaching, fit + `anova_content()` in 80 columns, list every guide in the site menu, and + cite Scheibe et al. from the 2002 edition + ([#78](https://github.com/JUhalt/contentvalidR/pull/78)). +- [x] State the handoff contract nomologR asked for, and record the joint 1.0 + checklist ([#79](https://github.com/JUhalt/contentvalidR/pull/79)). +- [x] Host the joint walkthrough here, pass nomologR the whole handoff, and + link nomologR's companion article on the same data + ([#80](https://github.com/JUhalt/contentvalidR/pull/80), + [#81](https://github.com/JUhalt/contentvalidR/pull/81)). +- [x] Add `content_evidence()`, with the item flow diagram and the item + evidence profile, the rating-distribution view, and the `apa` switch + ([#82](https://github.com/JUhalt/contentvalidR/pull/82)). +- [x] Set 2026-10-17 as release-candidate day, and install from CRAN first + ([#83](https://github.com/JUhalt/contentvalidR/pull/83)). + +CRAN: 0.4.0 was published on 2026-09-28. CRAN asks for updates no more often +than every one to two months, so 0.10.0 is not submitted; the next submission +is the joint 1.0. + +*** + ## v1.0.0 - Joint stable release with nomologR (proposed) **Status:** Proposed by the maintainer on 2026-09-19. Release candidate on