chore: JOSS paper by williambdean · Pull Request #2163 · pymc-labs/pymc-marketing

williambdean · 2026-01-04T20:16:43Z

Description

Add a JOSS paper. View the latest here: https://github.com/pymc-labs/pymc-marketing/blob/joss-paper/paper/paper.pdf

JOSS submission: https://joss.theoj.org/papers/afedae521cb802b435e3b0833ea2a14f

JOSS Submission Details

Version: v0.19.4
Branch: joss-paper
Zenodo DOI: 10.5281/zenodo.20187968 — once the JOSS review issue opens, post: @editorialbot set 10.5281/zenodo.20187968 as archive

Pending

Add Larry Dong as author once confirmed
Review by the JOSS team
🎉

Related Issue

Closes Publish paper about this package in JOSS #30
Related to #

Checklist

Checked that the pre-commit linting/style checks pass. Feel free to comment pre-commit.ci autofix to auto-fix.
Included tests that prove the fix is effective or that the new feature works
Added necessary documentation (docstrings and/or example notebooks) using numpydoc format.
If you are a pro: each commit corresponds to a relevant logical change

cursor · 2026-01-04T20:16:48Z

PR Summary

Low Risk
Documentation-only change adding manuscript sources; no runtime code paths or data handling are affected.

Overview
Adds a JOSS submission under paper/, including a new paper.md manuscript (metadata, summary, feature overview, funding/AI disclosure, etc.) and a paper.bib bibliography with the referenced citations.

No library code, APIs, or runtime behavior changes are included—this PR is purely publication/documentation content.

^{Written by Cursor Bugbot for commit daec1e5. This will update automatically on new commits. Configure here.}

Copilot

Pull request overview

This PR adds a JOSS (Journal of Open Source Software) paper for PyMC-Marketing, which is a preparatory step before formal submission to JOSS for peer review and publication.

Introduces a comprehensive academic paper describing PyMC-Marketing's features and capabilities
Includes bibliography with citations to relevant academic and technical sources
Provides example code demonstrating the library's key functionality

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 4 comments.

File	Description
paper/paper.md	JOSS paper manuscript containing summary, statement of need, installation instructions, key features, example usage, and community guidelines
paper/paper.bib	Bibliography file with BibTeX entries for all cited references in the paper

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

ColtAllen

In addition to the author section, should we also add usage examples for the other modules in the library?

williambdean · 2026-01-05T07:55:21Z

In addition to the author section, should we also add usage examples for the other modules in the library?

I'm actually leaning toward removing all examples. The guidelines I've seen appear to be
1K word count which we are already over.

juanitorduz

This looks great! I left a first round of comments (shall we also push the pdf to the branch?)

juanitorduz

missing ohter author ;)

williambdean · 2026-01-05T08:52:07Z

I've pushed up a version of the PDF. Please use:

docker run --rm \
    --volume $PWD/paper:/data \
    --user $(id -u):$(id -g) \
    --env JOURNAL=joss \
    openjournals/inara

to generate the draft. View it here: https://github.com/pymc-labs/pymc-marketing/blob/joss-paper/paper/paper.pdf

OriolAbril

not sure what is the timeline but it would also be nice to update the citation to the new arviz paper if possible, but also not a reason to delay the paper. It is key for #2098 but not used anywhere on main yet

Co-authored-by: Thomas Wiecki <thomas.wiecki@gmail.com>

OriolAbril · 2026-01-08T13:37:56Z

Do you have a rough ETA?

Ideally at some point next week, at most the other one.

juanitorduz · 2026-01-08T14:08:18Z

Do you have a rough ETA?

Ideally at some point next week, at most the other one.

Sure! We can wait, of course! 💪

PabloRoque · 2026-01-13T11:47:20Z

Any non-labs contributors that have done large enough contributions to deserve being authors?

@PabloRoque added ADVI support, the MG/BND model, and covariate support for beta distributions. His research on the latter also uncovered a bug in how the BYTDPlus R library handles covariates.

Hey, just seeing this after the long Xmas break.
I would be glad to be acknowledged as contributor. Should I add my ORCID?

Co-authored-by: Luciano Paz <luciano.paz.neuro@gmail.com>

juanitorduz · 2026-01-13T11:48:39Z

yes @PabloRoque ! That would be great!

PabloRoque

Added my ORCID

juanitorduz

adding @NathanielF

juanitorduz

I think we are just missing Carlos Id and then update the ArviZ reference right? @williambdean

williambdean · 2026-01-14T13:27:28Z

I think we are just missing Carlos Id and then update the ArviZ reference right? @williambdean

Yup. Then I will begin the submittal process. That seems to be long

OriolAbril · 2026-01-19T10:48:51Z

The ArviZ paper is already in pre-review: openjournals/joss-reviews#9786

juanitorduz

@williambdean did we update the arviz reference? anything else missing :) ?

drbenvincent · 2026-02-06T08:22:39Z

Based on this discussion from @ErikRingen, it made me realise I should update my affiliation to my company rather than Labs. Got to be careful on the tax side of things. Could be relevant for others with companies too?

cursor

Cursor Bugbot has reviewed your changes and found 1 potential issue.

juanitorduz

Looks great!

I suggest adding @isofer as a coauthor. Can you please provide your ORCID please?

isofer · 2026-05-05T18:36:58Z

Looks great!

I suggest adding @isofer as a coauthor. Can you please provide your ORCID please?

Just created one: https://orcid.org/0009-0002-5367-3850

- Add HelloFresh, Bolt, and Runge & Pauwels (2026) citations - Remove Lemonade preprint citation per team feedback - Remove Larry Dong pending affiliation confirmation - Fix Erik Ringen affiliation index after Larry removal - Rename Carlos to full legal name - Update MMM terminology to match repo style (Marketing Mix Models) - Add Imri Sofer as author - Update date to 14 May 2026 - Gitignore paper/jats/ build artifacts

initial paper

c9e4f03

github-actions Bot added the docs Improvements or additions to documentation label Jan 4, 2026

williambdean requested a review from Copilot January 4, 2026 20:29

Copilot started reviewing on behalf of williambdean January 4, 2026 20:30 View session

williambdean requested review from ColtAllen, cetagostini, drbenvincent, juanitorduz and ricardoV94 January 4, 2026 20:30

Copilot AI reviewed Jan 4, 2026

View reviewed changes

Comment thread paper/paper.md Outdated

Comment thread paper/paper.bib Outdated

Comment thread paper/paper.bib Outdated

Comment thread paper/paper.md Outdated

ColtAllen requested changes Jan 5, 2026

View reviewed changes

Comment thread paper/paper.md

williambdean added 2 commits January 5, 2026 02:57

placeholder for colt

4488536

remove the examples

fbe38ac

juanitorduz requested changes Jan 5, 2026

View reviewed changes

Comment thread paper/paper.md

Comment thread paper/paper.md

Comment thread paper/paper.md Outdated

Comment thread paper/paper.md Outdated

Comment thread paper/paper.md Outdated

Comment thread paper/paper.md Outdated

Comment thread paper/paper.md Outdated

Comment thread paper/paper.md Outdated

juanitorduz reviewed Jan 5, 2026

View reviewed changes

Comment thread paper/paper.md

juanitorduz reviewed Jan 5, 2026

View reviewed changes

williambdean added 3 commits January 5, 2026 03:49

update bib

4651550

feedback from Juan

f7a56a5

add pdf render

c634f77

williambdean added 2 commits January 5, 2026 04:16

push up edits

ab92faf

update paper

460fc9a

OriolAbril reviewed Jan 5, 2026

View reviewed changes

Comment thread paper/paper.bib Outdated

Comment thread paper/paper.md Outdated

Comment thread paper/paper.md Outdated

twiecki reviewed Jan 5, 2026

View reviewed changes

Comment thread paper/paper.md Outdated

twiecki reviewed Jan 5, 2026

View reviewed changes

Comment thread paper/paper.md Outdated

twiecki reviewed Jan 5, 2026

View reviewed changes

Comment thread paper/paper.md Outdated

add Thomas ORDID

8230ca5

Co-authored-by: Thomas Wiecki <thomas.wiecki@gmail.com>

drbenvincent requested changes Jan 6, 2026

View reviewed changes

Comment thread paper/paper.md Outdated

Update paper/paper.md

c8be0d7

Co-authored-by: Luciano Paz <luciano.paz.neuro@gmail.com>

Merge branch 'main' into joss-paper

2a90621

PabloRoque approved these changes Jan 13, 2026

View reviewed changes

Comment thread paper/paper.md

Update paper/paper.md

e2f7cfc

juanitorduz reviewed Jan 14, 2026

View reviewed changes

Comment thread paper/paper.md Outdated

Update paper/paper.md

a23afd7

juanitorduz reviewed Jan 14, 2026

View reviewed changes

Comment thread paper/paper.md Outdated

juanitorduz reviewed Jan 14, 2026

View reviewed changes

juanitorduz reviewed Feb 4, 2026

View reviewed changes

Comment thread paper/paper.md Outdated

update my affiliation to my company

da027e9

drbenvincent and others added 2 commits February 6, 2026 08:49

InferenceWorks -> InferenceWorks Ltd

fb0717f

Add Luciano company affiliation

81c2d4a

cursor Bot reviewed Feb 6, 2026

View reviewed changes

Comment thread paper/paper.md Outdated

cetagostini and others added 4 commits February 7, 2026 00:29

Carlos orcid

daec1e5

Merge branch 'main' into joss-paper

1734b53

Merge branch 'main' into joss-paper

ca7b992

Merge branch 'main' into joss-paper

575eb8b

juanitorduz approved these changes May 5, 2026

View reviewed changes

williambdean requested review from ColtAllen and drbenvincent May 5, 2026 23:41

williambdean force-pushed the joss-paper branch from a5dde59 to e4d5735 Compare May 15, 2026 01:26

Conversation

williambdean commented Jan 4, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Description

JOSS Submission Details

Pending

Related Issue

Checklist

Uh oh!

cursor Bot commented Jan 4, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

PR Summary

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

ColtAllen left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

williambdean commented Jan 5, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

juanitorduz left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

juanitorduz left a comment

Choose a reason for hiding this comment

Uh oh!

williambdean commented Jan 5, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

OriolAbril left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

OriolAbril commented Jan 8, 2026

Uh oh!

juanitorduz commented Jan 8, 2026

Uh oh!

PabloRoque commented Jan 13, 2026

Uh oh!

juanitorduz commented Jan 13, 2026

Uh oh!

PabloRoque left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

juanitorduz left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

juanitorduz left a comment

Choose a reason for hiding this comment

Uh oh!

williambdean commented Jan 14, 2026

Uh oh!

OriolAbril commented Jan 19, 2026

williambdean commented Jan 4, 2026 •

edited

Loading

cursor Bot commented Jan 4, 2026 •

edited

Loading

williambdean commented Jan 5, 2026 •

edited

Loading

williambdean commented Jan 5, 2026 •

edited

Loading

juanitorduz left a comment •

edited

Loading