docs(paper): refresh JOSS paper for current library and submission requirements by igerber · Pull Request #564 · igerber/diff-diff · GitHub
Skip to content

docs(paper): refresh JOSS paper for current library and submission requirements#564

Merged
igerber merged 1 commit into
mainfrom
docs/joss-paper-refresh
Jun 27, 2026
Merged

docs(paper): refresh JOSS paper for current library and submission requirements#564
igerber merged 1 commit into
mainfrom
docs/joss-paper-refresh

Conversation

@igerber

@igerber igerber commented Jun 27, 2026

Copy link
Copy Markdown
Owner

Summary

  • Refresh paper.md / paper.bib for the JOSS submission so they reflect the current library and meet current JOSS requirements.
  • Correct estimator count 17 -> 19; enumerate all 19 estimators by name and list diagnostics (Goodman-Bacon, Honest DiD, placebo tests, pre-trends power) separately.
  • Add a mandatory AI Usage Disclosure section (tool/version, scope of assistance, human-verification affirmation) per current JOSS policy.
  • Cite the companion arXiv preprint Gerber (2026, 2605.04124) in the Summary, Statement of Need, and Survey-weighted inference section.
  • Soften an overstated survey-validation tolerance (<1e-10 -> test gaps <1e-8, typically <1e-10) and correct "three federal datasets" (the API dataset is California state data, not federal).
  • Add 4 bib entries (Gerber2026, Abadie2010, Butts2021, deChaisemartin2026) and add arXiv/Springer DOIs across the bibliography.
  • Remove the Acknowledgments section (Wenli Xu remains credited in CONTRIBUTORS.md); update date to 3 July 2026.

Methodology references (required if estimator / math changes)

  • Method name(s): N/A - no methodology or code changes (paper files only)
  • Paper / source link(s): N/A
  • Any intentional deviations from the source (and why): None

Validation

  • Tests added/updated: No test changes
  • Backtest / simulation / notebook evidence (if applicable): N/A. Verified all 24 paper citations resolve to paper.bib (no orphan/duplicate keys); paper claims cross-checked against docs/benchmarks.rst and tests/test_survey_real_data.py.

Security / privacy

  • Confirm no secrets/PII in this PR: Yes

Generated with Claude Code

…quirements

Update paper.md and paper.bib so the JOSS submission reflects the current
library and meets current JOSS requirements.

- Correct estimator count 17 -> 19; enumerate all 19 by name and list
  diagnostics (Goodman-Bacon, Honest DiD, placebo, pre-trends power) separately
- Add a mandatory AI Usage Disclosure section (tool/version, scope of
  assistance, human-verification affirmation)
- Cite the companion arXiv preprint Gerber (2026, 2605.04124) in the Summary,
  Statement of Need, and Survey-weighted inference section
- Soften an overstated survey-validation tolerance (<1e-10 -> test gaps <1e-8,
  typically <1e-10) and correct "three federal datasets" (the API dataset is
  California state data, not federal)
- Add 4 bib entries (Gerber2026, Abadie2010, Butts2021, deChaisemartin2026) and
  add arXiv/Springer DOIs across the bibliography
- Remove the Acknowledgments section (Wenli Xu remains credited in CONTRIBUTORS.md)
- Update date to 3 July 2026

Docs-only change to the paper files; no library code touched.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@github-actions

Copy link
Copy Markdown

@igerber igerber added the ready-for-ci Triggers CI test workflows label Jun 27, 2026
@igerber igerber merged commit 8733faa into main Jun 27, 2026
5 of 6 checks passed
@igerber igerber deleted the docs/joss-paper-refresh branch June 27, 2026 23:51
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

ready-for-ci Triggers CI test workflows

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant