From 9caaf1d1f884b4e63efadf427da559843642685d Mon Sep 17 00:00:00 2001
From: Matthew Feickert <matthew.feickert@cern.ch>
Date: Wed, 25 Oct 2023 00:44:33 -0500
Subject: [PATCH] docs(backport): Update citations and docs (#2360)

* Backport:
   - PR https://github.com/scikit-hep/pyhf/pull/2341
   - PR https://github.com/scikit-hep/pyhf/pull/2345
   - PR https://github.com/scikit-hep/pyhf/pull/2349
   - PR https://github.com/scikit-hep/pyhf/pull/2354
   - PR https://github.com/scikit-hep/pyhf/pull/2355
   - PR https://github.com/scikit-hep/pyhf/pull/2356
---
 README.rst                     |  9 ++++--
 docs/bib/general_citations.bib | 24 ++++++++++++++++
 docs/bib/use_citations.bib     | 50 ++++++++++++++++++++++++++++++++++
 3 files changed, 80 insertions(+), 3 deletions(-)

diff --git a/README.rst b/README.rst
index b536b9a08c..cf10370fdd 100644
--- a/README.rst
+++ b/README.rst
@@ -6,7 +6,7 @@
 pure-python fitting/limit-setting/interval estimation HistFactory-style
 =======================================================================
 
-|GitHub Project| |DOI| |JOSS DOI| |Scikit-HEP| |NSF Award Number| |NumFOCUS Affiliated Project|
+|GitHub Project| |DOI| |JOSS DOI| |Scikit-HEP| |NSF Award Number IRIS-HEP v1| |NSF Award Number IRIS-HEP v2| |NumFOCUS Affiliated Project|
 
 |Docs from latest| |Docs from main| |Jupyter Book tutorial| |Binder|
 
@@ -348,7 +348,8 @@ Acknowledgements
 ----------------
 
 Matthew Feickert has received support to work on ``pyhf`` provided by NSF
-cooperative agreement `OAC-1836650 <https://www.nsf.gov/awardsearch/showAward?AWD_ID=1836650>`__ (IRIS-HEP)
+cooperative agreements `OAC-1836650 <https://nsf.gov/awardsearch/showAward?AWD_ID=1836650>`__
+and `PHY-2323298 <https://nsf.gov/awardsearch/showAward?AWD_ID=2323298>`__ (IRIS-HEP)
 and grant `OAC-1450377 <https://www.nsf.gov/awardsearch/showAward?AWD_ID=1450377>`__ (DIANA/HEP).
 
 ``pyhf`` is a `NumFOCUS Affiliated Project <https://numfocus.org/sponsored-projects/affiliated-projects>`__.
@@ -361,8 +362,10 @@ and grant `OAC-1450377 <https://www.nsf.gov/awardsearch/showAward?AWD_ID=1450377
    :target: https://doi.org/10.21105/joss.02823
 .. |Scikit-HEP| image:: https://scikit-hep.org/assets/images/Scikit--HEP-Project-blue.svg
    :target: https://scikit-hep.org/
-.. |NSF Award Number| image:: https://img.shields.io/badge/NSF-1836650-blue.svg
+.. |NSF Award Number IRIS-HEP v1| image:: https://img.shields.io/badge/NSF-1836650-blue.svg
    :target: https://nsf.gov/awardsearch/showAward?AWD_ID=1836650
+.. |NSF Award Number IRIS-HEP v2| image:: https://img.shields.io/badge/NSF-2323298-blue.svg
+   :target: https://nsf.gov/awardsearch/showAward?AWD_ID=2323298
 .. |NumFOCUS Affiliated Project| image:: https://img.shields.io/badge/NumFOCUS-Affiliated%20Project-orange.svg?style=flat&colorA=E1523D&colorB=007D8A
    :target: https://numfocus.org/sponsored-projects/affiliated-projects
 .. |Docs from latest| image:: https://img.shields.io/badge/docs-v0.7.4-blue.svg
diff --git a/docs/bib/general_citations.bib b/docs/bib/general_citations.bib
index d996d587b6..068c66a582 100644
--- a/docs/bib/general_citations.bib
+++ b/docs/bib/general_citations.bib
@@ -1,3 +1,27 @@
+% 2023-10-19
+@article{Smith:2023ssh,
+    author = "Smith, Rachel E. C. and Ochoa, In\^es and In\'acio, R\'uben and Shoemaker, Jonathan and Kagan, Michael",
+    title = "{Differentiable Vertex Fitting for Jet Flavour Tagging}",
+    eprint = "2310.12804",
+    archivePrefix = "arXiv",
+    primaryClass = "hep-ex",
+    month = "10",
+    year = "2023",
+    journal = ""
+}
+
+% 2023-09-25
+@inproceedings{Feickert:2023ajm,
+    author = "Feickert, Matthew and Katz, Daniel S. and Neubauer, Mark S. and Sexton-Kennedy, Elizabeth and Stewart, Graeme A.",
+    title = "{Software Citation in HEP: Current State and Recommendations for the Future}",
+    booktitle = "{26th International Conference on Computing in High Energy \& Nuclear Physics}",
+    eprint = "2309.14571",
+    archivePrefix = "arXiv",
+    primaryClass = "hep-ex",
+    month = "9",
+    year = "2023"
+}
+
 % 2023-08-31
 @article{Kagan:2023gxz,
     author = "Kagan, Michael and Heinrich, Lukas",
diff --git a/docs/bib/use_citations.bib b/docs/bib/use_citations.bib
index dd4a8ec7f2..1bb8fe3465 100644
--- a/docs/bib/use_citations.bib
+++ b/docs/bib/use_citations.bib
@@ -1,3 +1,53 @@
+% 2023-10-13
+@article{Gavranovic:2023oam,
+    author = "Gavranovi\v{c}, Jan and Ker\v{s}evan, Borut Paul",
+    title = "{Systematic Evaluation of Generative Machine Learning Capability to Simulate Distributions of Observables at the Large Hadron Collider}",
+    eprint = "2310.08994",
+    archivePrefix = "arXiv",
+    primaryClass = "hep-ph",
+    month = "10",
+    year = "2023",
+    journal = ""
+}
+
+% 2023-10-11
+@article{MicroBooNE:2023icy,
+    author = "{MicroBooNE Collaboration}",
+    title = "{Search for heavy neutral leptons in electron-positron and neutral-pion final states with the MicroBooNE detector}",
+    eprint = "2310.07660",
+    archivePrefix = "arXiv",
+    primaryClass = "hep-ex",
+    reportNumber = "FERMILAB-PUB-23-574-ND",
+    month = "10",
+    year = "2023",
+    journal = ""
+}
+
+% 2023-09-29
+@inproceedings{Feickert:2023hhr,
+    author = "Feickert, Matthew and Heinrich, Lukas and Horstmann, Malin",
+    title = "{Bayesian Methodologies with pyhf}",
+    booktitle = "{26th International Conference on Computing in High Energy \& Nuclear Physics}",
+    eprint = "2309.17005",
+    archivePrefix = "arXiv",
+    primaryClass = "stat.CO",
+    month = "9",
+    year = "2023"
+}
+
+% 2023-09-20
+@article{Belfkir:2023vpo,
+    author = "Belfkir, Mohamed and Jueid, Adil and Nasri, Salah",
+    title = "{Boosting dark matter searches at muon colliders with Machine Learning: the mono-Higgs channel as a case study}",
+    eprint = "2309.11241",
+    archivePrefix = "arXiv",
+    primaryClass = "hep-ph",
+    reportNumber = "CTPU-PTC-23-37",
+    month = "9",
+    year = "2023",
+    journal = ""
+}
+
 % 2023-09-04
 @article{Fenton:2023ikr,
     author = "Fenton, Michael James and Shmakov, Alexander and Okawa, Hideki and Li, Yuji and Hsiao, Ko-Yang and Hsu, Shih-Chieh and Whiteson, Daniel and Baldi, Pierre",