summarized in this comment: https://github.com/expnt/herald/pull/35#discussion_r2066907935
summarized in this comment: #35 (comment)