docs: make citation guidance unmissable (multigroup.vaccine)

R/zzz.R

@@ -0,0 +1,5 @@
+.onAttach <- function(libname, pkgname) {
+  packageStartupMessage(
+    "Using multigroup.vaccine in your research? Please cite it: citation(\"multigroup.vaccine\")"
+  )
+}

README.Rmd

@@ -16,6 +16,16 @@ knitr::opts_chunk$set(
 # multigroup.vaccine
 
 <!-- badges: start -->
+
+<!-- how-to-cite -->
+> [!NOTE]
+> **How to cite multigroup.vaccine.** If you use **multigroup.vaccine** in published work, please cite it:
+>
+> Toth D, Wagoner J, Ray W, Vega Yon G. *multigroup.vaccine: Analyze Outbreak Models of Multi-Group Populations with Vaccination*. doi:[10.32614/CRAN.package.multigroup.vaccine](https://doi.org/10.32614/CRAN.package.multigroup.vaccine)
+>
+> Run `citation("multigroup.vaccine")` in R for the BibTeX entry.
+<!-- how-to-cite -->
+
 ```{=markdown}
 [![ForeSITE Group](https://github.com/EpiForeSITE/software/raw/e82ed88f75e0fe5c0a1a3b38c2b94509f122019c/docs/assets/foresite-software-badge.svg)](https://github.com/EpiForeSITE)
 [![R-CMD-check](https://github.com/EpiForeSITE/multigroup-vaccine/actions/workflows/R-CMD-check.yaml/badge.svg)](https://github.com/EpiForeSITE/multigroup-vaccine/actions/workflows/R-CMD-check.yaml)

README.md

@@ -13,6 +13,16 @@
 
 <!-- badges: end -->
 
+
+<!-- how-to-cite -->
+> [!NOTE]
+> **How to cite multigroup.vaccine.** If you use **multigroup.vaccine** in published work, please cite it:
+>
+> Toth D, Wagoner J, Ray W, Vega Yon G. *multigroup.vaccine: Analyze Outbreak Models of Multi-Group Populations with Vaccination*. doi:[10.32614/CRAN.package.multigroup.vaccine](https://doi.org/10.32614/CRAN.package.multigroup.vaccine)
+>
+> Run `citation("multigroup.vaccine")` in R for the BibTeX entry.
+<!-- how-to-cite -->
+
 ## Overview
 
 `multigroup.vaccine` models infectious disease dynamics in populations

inst/CITATION

@@ -1,9 +1,27 @@
+# Year resolution: CRAN sets Date/Publication on the installed package; fall
+# back to DESCRIPTION's Date, then to the current year, so the package entry
+# never renders as "(????)".
+year <- if (!is.null(meta$`Date/Publication`)) {
+  substr(meta$`Date/Publication`, 1, 4)
+} else if (!is.null(meta$Date)) {
+  substr(meta$Date, 1, 4)
+} else {
+  format(Sys.Date(), "%Y")
+}
+note <- sprintf("R package version %s", meta$Version)
+
 bibentry(
   bibtype = "Manual",
-  title = "multigroup.vaccine: Analyze Outbreak Models of Multi-Group Populations with Vaccination",
-  author = c(person("Damon", "Toth"), person("Jake", "Wagoner"), person("Willy", "Ray"),
-  person("George", "Vega Yon")),
-  year = "2026",
-  note = "R package version 0.1.1",
-  url = "https://epiforesite.github.io/multigroup-vaccine/"
+  title   = "{{multigroup.vaccine: Analyze Outbreak Models of Multi-Group Populations with Vaccination}}",
+  author  = c(
+    person("Damon", "Toth", comment = c(ORCID = "0000-0001-7393-4814")),
+    person("Jake", "Wagoner", comment = c(ORCID = "0009-0000-5053-2281")),
+    person("Willy", "Ray"),
+    person("George", "Vega Yon", comment = c(ORCID = "0000-0002-3171-0844"))
+  ),
+  year    = year,
+  note    = note,
+  url     = "https://epiforesite.github.io/multigroup-vaccine/",
+  doi     = "10.32614/CRAN.package.multigroup.vaccine",
+  header  = "To cite multigroup.vaccine in publications use:"
 )

vignettes/census_functions_demo.Rmd

@@ -7,6 +7,11 @@ vignette: >
   %\VignetteEncoding{UTF-8}
 ---
 
+<!-- how-to-cite -->
+> **How to cite.** If you use **multigroup.vaccine** in published work, please cite it — run
+> `citation("multigroup.vaccine")` in R for the full entry.
+<!-- how-to-cite -->
+
 ```{r, include = FALSE}
 knitr::opts_chunk$set(
   collapse = TRUE,

vignettes/contact_matrix_examples.Rmd

@@ -7,6 +7,11 @@ vignette: >
   %\VignetteEncoding{UTF-8}
 ---
 
+<!-- how-to-cite -->
+> **How to cite.** If you use **multigroup.vaccine** in published work, please cite it — run
+> `citation("multigroup.vaccine")` in R for the full entry.
+<!-- how-to-cite -->
+
 ```{r, include = FALSE}
 knitr::opts_chunk$set(
   collapse = TRUE,

vignettes/measles_agemodel.Rmd

@@ -7,6 +7,11 @@ vignette: >
   %\VignetteEncoding{UTF-8}
 ---
 
+<!-- how-to-cite -->
+> **How to cite.** If you use **multigroup.vaccine** in published work, please cite it — run
+> `citation("multigroup.vaccine")` in R for the full entry.
+<!-- how-to-cite -->
+
 ```{r, include = FALSE}
 knitr::opts_chunk$set(
   collapse = TRUE,

vignettes/run_model_on_command_line.Rmd

@@ -8,6 +8,11 @@ vignette: >
 
 ---
 
+<!-- how-to-cite -->
+> **How to cite.** If you use **multigroup.vaccine** in published work, please cite it — run
+> `citation("multigroup.vaccine")` in R for the full entry.
+<!-- how-to-cite -->
+
 ```{r, include = FALSE}
 knitr::opts_chunk$set(
   collapse = TRUE,