Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions CITATION.cff
Original file line number Diff line number Diff line change
Expand Up @@ -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
2 changes: 1 addition & 1 deletion DESCRIPTION
Original file line number Diff line number Diff line change
@@ -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"))
Expand Down
48 changes: 36 additions & 12 deletions NEWS.md
Original file line number Diff line number Diff line change
@@ -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
Expand Down Expand Up @@ -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
Expand Down
2 changes: 1 addition & 1 deletion README.Rmd
Original file line number Diff line number Diff line change
Expand Up @@ -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)
<!-- badges: end -->

**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).
Expand Down
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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)
<!-- badges: end -->

**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:
Expand Down
31 changes: 31 additions & 0 deletions ROADMAP.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
Loading