diff --git a/CITATION.cff b/CITATION.cff index be80c97..c3b4d02 100644 --- a/CITATION.cff +++ b/CITATION.cff @@ -5,8 +5,8 @@ type: software authors: - family-names: Uhalt given-names: Joshua -version: 0.8.0 -date-released: 2026-09-26 +version: 0.9.0 +date-released: 2026-09-27 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 81657d4..d7a5f6d 100644 --- a/DESCRIPTION +++ b/DESCRIPTION @@ -1,7 +1,7 @@ Package: contentvalidR Type: Package Title: Tools for Substantive and Content Validity Pretesting -Version: 0.8.0.9000 +Version: 0.9.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 ddf82ba..0146282 100644 --- a/NEWS.md +++ b/NEWS.md @@ -1,6 +1,41 @@ -# contentvalidR 0.8.0.9000 (development version) +# contentvalidR 0.9.0 -## A README that is a front page (in development) +Ninth public release. v0.9.0 is about how the package presents itself before +1.0. Every reference list is in APA 7 form; printed output is shorter and says +what it means; the component functions and report tables print in APA style; +the figures show the criterion and the uncertainty; and the README is a front +page rather than a manual. + +The package continues to declare `Imports: stats` only. + +**No computed value changes.** Across 25 analyses spanning every workflow, +every value 0.8.0 returns is identical in 0.9.0. Some wording changes: the +scale-level summaries of the item-sort and construct-rating workflows name the +Colquitt band of the weaker index, counts read "1 item" or "3 items", and the +note when judge severity cannot be estimated no longer blames near-total +agreement when one dissenting judge causes it. + +**Breaking changes.** + +* `content_report()` writes an APA table by default. For the numeric table + that used to be the default, pass `format = "data.frame"`; its *p* values + now keep three decimals whatever `digits` is. +* The component functions' results (`compute_psa()`, `aikens_v()`, `cvr()`, + and eleven others) gain a class, so they print as formatted tables. Every + value is unchanged and `as.data.frame()` returns the plain data frame; only + code that tests `class(x) == "data.frame"` exactly would notice. + +**Deprecated.** `agreement_summary()` warns and will be removed in 1.0.0; use +`panel_agreement()`, which takes raters in rows like every other ratings +function. + +New: `content_report(format = "apa")`, and `csv_binom_test()` returns its +inputs (`n_target`, `N`, `p0`, `alpha`) beside its result. + +Published on GitHub and R-universe. 0.4.0 is still in CRAN's review queue, and +CRAN policy asks that no further version be submitted while one is pending. + +## A README that is a front page * **The README is a front page rather than a manual.** It ran to about 1,400 lines of printed output: every workflow in full, the component functions, @@ -15,7 +50,7 @@ design would need. Its method list now names all six workflows, and it has a reference list. -## Plots show the criterion and the uncertainty (in development) +## Plots show the criterion and the uncertainty No computed value changes; this is about what the figures draw. @@ -41,7 +76,7 @@ No computed value changes; this is about what the figures draw. * **Every figure in the README and the vignettes has alt text** describing what it shows; 17 of 19 had none. -## Shorter keys, formatted components, and APA report tables (in development) +## Shorter keys, formatted components, and APA report tables No computed value changes; this is about what is printed. @@ -73,7 +108,7 @@ No computed value changes; this is about what is printed. `digits` is. The construct-rating table shows the contrast *p* beside the omnibus *p*, since a Review item can have an omnibus *p* below .001. -## `agreement_summary()` is deprecated (in development) +## `agreement_summary()` is deprecated * **Deprecated in 0.9.0, to be removed in 1.0.0.** Use `panel_agreement()`. `agreement_summary()` is the only function that takes items in rows; every @@ -84,7 +119,7 @@ No computed value changes; this is about what is printed. it at 1.0.0 leaves nothing deprecated past 1.0, as the stability policy in `?contentvalidR` sets out. -## References follow APA 7 everywhere (in development) +## References follow APA 7 everywhere * **One reference list, installed in BibTeX form.** `REFERENCES.bib` held 13 of the works the package cites, and one it no longer cited; it now holds all @@ -104,7 +139,7 @@ No computed value changes; this is about what is printed. * `citation("contentvalidR")` prints the package reference in APA form, with its version and "[Computer software]". -## Printed output says what it means (in development) +## Printed output says what it means * **The expert-panel print opens with its verdict**, as the other workflows' prints do: how many items met the criterion, then the flagged items by name. diff --git a/README.Rmd b/README.Rmd index a464af2..20b9e14 100644 --- a/README.Rmd +++ b/README.Rmd @@ -25,7 +25,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.8.0.** +**Current stable release: 0.9.0.** 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). Documentation: [Package website](https://juhalt.github.io/contentvalidR/) · [Changelog](https://juhalt.github.io/contentvalidR/news/index.html). diff --git a/README.md b/README.md index aa3fb8e..a5ed1a6 100644 --- a/README.md +++ b/README.md @@ -12,7 +12,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.8.0.** +**Current stable release: 0.9.0.** Development plans: [Roadmap](https://github.com/JUhalt/contentvalidR/blob/master/ROADMAP.md) diff --git a/ROADMAP.md b/ROADMAP.md index f673bab..15c93d2 100644 --- a/ROADMAP.md +++ b/ROADMAP.md @@ -747,6 +747,35 @@ tag. *** +## v0.9.0 - Ready to be read: references, output, plots, and the README + +**Status:** Released (0.9.0 on 2026-09-27, on GitHub and R-universe) +**Version:** `0.9.0` + +Work: [#72](https://github.com/JUhalt/contentvalidR/pull/72) to +[#75](https://github.com/JUhalt/contentvalidR/pull/75). The maintainer asked +for everything a user sees to be ready before 1.0; an output gallery of every +print, summary, and plot set the list. + +- [x] Put every reference list in APA 7 form and fix what the output misstated + ([#72](https://github.com/JUhalt/contentvalidR/pull/72)): the installed + BibTeX file holds all 53 cited works, checked against Crossref; lists are + alphabetical with en dashes; the expert-panel print opens with its + verdict; the modified-kappa range is corrected. +- [x] Show a short key tailored to each result, print the component functions + in APA style, make `content_report()` APA by default, and deprecate + `agreement_summary()` ([#73](https://github.com/JUhalt/contentvalidR/pull/73)). +- [x] Make the plots show the criterion and the uncertainty, and give every + figure alt text ([#74](https://github.com/JUhalt/contentvalidR/pull/74)). +- [x] Make the README a front page and move its planning examples to a + vignette ([#75](https://github.com/JUhalt/contentvalidR/pull/75)). + +CRAN: unchanged. 0.4.0 is still in review, so 0.9.0 is not submitted; whichever +version is current when 0.4.0 resolves goes to CRAN as the update, from its own +tag. + +*** + ## v1.0.0 - Joint stable release with nomologR (proposed) **Status:** Proposed by the maintainer on 2026-09-19. Not scheduled.