citHeader("To cite magentabook in publications use:")

bibentry(
  bibtype = "Manual",
  title   = "magentabook: HM Treasury Magenta Book Policy Evaluation Primitives",
  author  = person("Charles", "Coverdale"),
  year    = "2026",
  note    = sprintf("R package version %s", meta$Version),
  url     = "https://github.com/charlescoverdale/magentabook",
  textVersion = paste0(
    "Coverdale, C. (2026). magentabook: HM Treasury Magenta Book ",
    "Policy Evaluation Primitives. R package version ", meta$Version,
    ". https://github.com/charlescoverdale/magentabook"
  )
)

citFooter(
  "magentabook is aligned with the May 2026 republication of the",
  "HM Treasury Magenta Book and its companion Annex A on analytical",
  "methods. When magentabook is used to implement specific named",
  "methods, please also cite the underlying primary source. The most",
  "common are:",
  "",
  "  Sherman et al. (1997) for the Maryland Scientific Methods Scale.",
  "  Cohen (1988) for two-sample power analysis.",
  "  Hussey & Hughes (2007) and Hemming et al. (2015) for stepped-wedge designs.",
  "  Hedges & Hedberg (2007) for ICC reference values in education.",
  "  Drummond et al. (2015) for cost-effectiveness analysis.",
  "  Cameron & Miller (2015) for cluster-robust inference.",
  "  Stuart (2010) for pre-treatment balance diagnostics.",
  "  HM Treasury (2026). The Magenta Book: Central Government Guidance on Evaluation.",
  "  HM Treasury (2026). The Magenta Book: Annex A, Analytical methods for use within an evaluation.",
  "",
  "See the @references block of each function for the full citation."
)
