Skip to content

Commit 9c6e0e4

Browse files
docs: append full ACL-format References sections to remaining doc pages
For every doc page that cites at least one paper through a DOI / arXiv / ACL / JSTOR / Cambridge link but lacked a References section, append a ## References section with the canonical author-year-title-venue-volume-pages entry pulled directly from the publisher's page during this audit. Citation strings are drawn from a verified mapping built across the session covering ~90 unique sources (Giry 1982; Kock 1972; Fritz 2020; Cho & Jacobs 2019; Joyal Street Verity 1996; Booth & Thompson 1973; Robbins & Monro 1951; Varin Reid & Firth 2011; Lafferty McCallum Pereira 2001; Lambek 1958; Carlin Gelfand Smith 1992; Lambert 1992; Spearman 1904 — at the corrected JSTOR ID 1412107; Nelder & Wedderburn 1972; Tierney & Kadane 1986; Casella & Robert 1996; Carvalho Polson Scott 2010; Kalman 1960; Rabiner 1989; Tipping & Bishop 1999; Stephens 2000; Hochreiter & Schmidhuber 1997; MacKay 1992; Rauch Tung Striebel 1965; Kim Shephard Chib 1998; Krishnan Shalit Sontag 2017; Blei Ng Jordan 2003; Hoffman Blei Wang Paisley 2013; Hoffman & Gelman 2014; Lewandowski Kurowicka Joe 2009; Bartholomew Knott Moustaki 2011; Klein & Moeschberger 2003; Ferrari & Cribari-Neto 2004; Papaspiliopoulos Roberts Sköld 2007; Yao et al. 2018; Vehtari et al. 2021; Neal 2003; Neal 2011; Gelman & Shirley 2011; Gelman et al. 2013; Vehtari Gelman Gabry 2017; Vehtari Simpson Gelman Yao Gabry 2024; the various arXiv preprints for normalizing flows / HMC / annealing / GRU / LSTM / Transformer / BERT; Montague 1973; Moggi 1991; Hughes 2000; Plotkin & Power 2003; Bauer & Pretnar 2015; Lawvere 1973; Cartmell 1986; Hutton 1999; Shieber Schabes Pereira 1995; Pereira & Warren 1983; Klein & Manning 2001; Knuth 1977; Nederhof 2003; McAllester 2002; Goodman 1999; Huang & Chiang 2005; Bumford & Charlow 2026). 14 files updated; combined with the earlier round, every doc page under docs/guides/, docs/examples/, and docs/tutorials/qvr/ that uses a bibliographic citation now has a References section.
1 parent 8f0a812 commit 9c6e0e4

14 files changed

Lines changed: 83 additions & 0 deletions

docs/examples/ar1.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -108,3 +108,8 @@ for name, samples in result.samples.items():
108108
## Categorical Perspective
109109

110110
The model is a Kleisli morphism in the [Giry monad](https://doi.org/10.1007/BFb0092872)'s Kleisli category whose denotation is the standard AR(1) joint $p(\alpha, \phi, \sigma) \prod_t \mathcal{N}(y_t \mid \alpha + \phi y_{t-1}, \sigma)$. The `Step`-indexed plate is the [right Kan extension](https://ncatlab.org/nlab/show/Kan+extension) of the per-step Normal kernel along the trivial projection $\mathrm{Step} \to \mathbf{1}$.
111+
112+
113+
## References
114+
115+
- Michèle Giry. 1982. A categorical approach to probability theory. In Bernhard Banaschewski, editor, *Categorical Aspects of Topology and Analysis*, volume 915 of *Lecture Notes in Mathematics*, pages 68–85. Springer, Berlin, Heidelberg.

docs/examples/bidirectional-rnn-lm.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -159,3 +159,9 @@ print(f"divergences: {int(result.divergence_counts.sum())}")
159159
## Categorical Perspective
160160

161161
The model denotes a Kleisli morphism $\mathrm{Token} \to \mathcal{G}(\mathrm{Token})$ assembled by `fan`-composing two independent scan-folds and following with a merge. The `fan` combinator is the diagonal-pair construction $f \times g \circ \Delta$ in the Kleisli category that delivers a common input to both branches; `combine` is the merge $\mathrm{Hidden}^2 \to \mathcal{G}(\mathrm{Combined})$ that pulls the bilinear pairing back onto a single object. The Categorical head closes with the masked-token likelihood as a sub-probability kernel.
162+
163+
164+
## References
165+
166+
- Jacob Devlin, Ming-Wei Chang, Kenton Lee, and Kristina Toutanova. 2019. BERT: Pre-training of deep bidirectional transformers for language understanding. In *Proceedings of the 2019 Conference of the North American Chapter of the Association for Computational Linguistics: Human Language Technologies (NAACL-HLT)*, pages 4171–4186. ACL.
167+
- Michèle Giry. 1982. A categorical approach to probability theory. In Bernhard Banaschewski, editor, *Categorical Aspects of Topology and Analysis*, volume 915 of *Lecture Notes in Mathematics*, pages 68–85. Springer, Berlin, Heidelberg.

docs/examples/changepoint.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -113,3 +113,10 @@ for name, samples in result.samples.items():
113113
## Categorical Perspective
114114

115115
The model is a Kleisli morphism in the [Giry monad](https://doi.org/10.1007/BFb0092872)'s Kleisli category whose denotation is the joint $p(\tau, r_1, r_2) \prod_t \mathrm{Poisson}(y_t \mid r(t; \tau, r_1, r_2))$. The soft indicator is the [reparameterisation gradient](https://doi.org/10.48550/arXiv.1312.6114)-friendly relaxation of an indicator function; in the hard-change-point variant, the discrete `tau_idx` is integrated out by `marginalize`, realizing the right Kan extension along the trivial projection from the time axis to a singleton.
116+
117+
118+
## References
119+
120+
- Bradley P. Carlin, Alan E. Gelfand, and Adrian F. M. Smith. 1992. Hierarchical Bayesian analysis of changepoint problems. *Journal of the Royal Statistical Society Series C: Applied Statistics*, 41(2):389–405.
121+
- Diederik P. Kingma and Max Welling. 2013. Auto-Encoding Variational Bayes. arXiv preprint arXiv:1312.6114.
122+
- Michèle Giry. 1982. A categorical approach to probability theory. In Bernhard Banaschewski, editor, *Categorical Aspects of Topology and Analysis*, volume 915 of *Lecture Notes in Mathematics*, pages 68–85. Springer, Berlin, Heidelberg.

docs/examples/deep-markov.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -140,3 +140,9 @@ flowchart LR
140140
h_emit["h_emit"] --> emit_mlp_2["emit_mlp_2"]
141141
emit_mlp_2["emit_mlp_2"] --> o_t["o_t"]
142142
```
143+
144+
145+
## References
146+
147+
- Diederik P. Kingma and Max Welling. 2013. Auto-Encoding Variational Bayes. arXiv preprint arXiv:1312.6114.
148+
- Rahul G. Krishnan, Uri Shalit, and David Sontag. 2017. Structured inference networks for nonlinear state space models. In *Proceedings of the Thirty-First AAAI Conference on Artificial Intelligence (AAAI '17)*, pages 2101–2109. AAAI Press.

docs/examples/gru-lm.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -175,3 +175,9 @@ print(f"divergences: {int(result.divergence_counts.sum())}")
175175
## Categorical Perspective
176176

177177
The GRU cell is a Kleisli morphism $\mathrm{Embedded} \times \mathrm{Hidden} \to \mathcal{G}(\mathrm{Hidden})$ in the [Giry monad](https://doi.org/10.1007/BFb0092872)'s Kleisli category; `scan(gru_cell)` is its iterated composition along the sequence. The Categorical head and `observe` step close the composite into the LM likelihood by accumulating per-batch categorical log-probabilities.
178+
179+
180+
## References
181+
182+
- Kyunghyun Cho, Bart van Merriënboer, Caglar Gulcehre, Dzmitry Bahdanau, Fethi Bougares, Holger Schwenk, and Yoshua Bengio. 2014. Learning phrase representations using RNN encoder–decoder for statistical machine translation. In *Proceedings of the 2014 Conference on Empirical Methods in Natural Language Processing (EMNLP)*, pages 1724–1734, Doha, Qatar. Association for Computational Linguistics.
183+
- Michèle Giry. 1982. A categorical approach to probability theory. In Bernhard Banaschewski, editor, *Categorical Aspects of Topology and Analysis*, volume 915 of *Lecture Notes in Mathematics*, pages 68–85. Springer, Berlin, Heidelberg.

docs/examples/hmm.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -148,3 +148,8 @@ print(f"divergences: {int(result.divergence_counts.sum())}")
148148
The forward algorithm and the Viterbi algorithm are the same composed morphism evaluated in different [algebras](https://ncatlab.org/nlab/show/algebra): under product, composition multiplies probabilities and summation marginalizes; under tropical, composition adds log-probabilities and summation maximizes. Quivers makes this explicit: switching `algebra` changes the V-enriched composition rule without touching the program text.
149149

150150
The row-wise Dirichlet prior is the standard conjugate prior for a categorical kernel; declaring it via `over cod iid over dom` resolves the axis-role ambiguity that distinguishes a flat Dirichlet on $|State|\cdot|State|$ entries (wrong: not row-stochastic) from $|State|$ independent simplex draws (right). The categorical reading: each row of $T$ is a fiber of the dependent kernel $\prod_{c \,:\, \mathrm{State}} \mathcal{G}(\mathrm{State})$, so the prior factors as a product of independent simplex priors.
151+
152+
153+
## References
154+
155+
- Michèle Giry. 1982. A categorical approach to probability theory. In Bernhard Banaschewski, editor, *Categorical Aspects of Topology and Analysis*, volume 915 of *Lecture Notes in Mathematics*, pages 68–85. Springer, Berlin, Heidelberg.

docs/examples/irt-2pl.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -117,3 +117,8 @@ print(f"divergences: {int(result.divergence_counts.sum())}")
117117
## Categorical Perspective
118118

119119
The 2PL is a Kleisli morphism over the Person + Item plate structure in the [Giry monad](https://doi.org/10.1007/BFb0092872)'s Kleisli category. The plate-gather operations are pullbacks of indexed kernels along the response-row index maps `person_idx : Resp -> Person` and `item_idx : Resp -> Item`.
120+
121+
122+
## References
123+
124+
- Michèle Giry. 1982. A categorical approach to probability theory. In Bernhard Banaschewski, editor, *Categorical Aspects of Topology and Analysis*, volume 915 of *Lecture Notes in Mathematics*, pages 68–85. Springer, Berlin, Heidelberg.

docs/examples/lda.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -131,3 +131,8 @@ The discrete per-word topic $z : \mathsf{Topic}$ is integrated out by the [pushf
131131
## See Also
132132

133133
- [Bayesian Gaussian Mixture Model](mixture-model.md) for a simpler grouped `marginalize` over a discrete latent.
134+
135+
136+
## References
137+
138+
- David M. Blei, Andrew Y. Ng, and Michael I. Jordan. 2003. Latent Dirichlet allocation. *Journal of Machine Learning Research*, 3:993–1022.

docs/examples/linear-gaussian-ssm.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -137,3 +137,10 @@ flowchart LR
137137
u_2["u_2"] --> transition_cell_2["transition_cell_2"]
138138
transition_cell_2["transition_cell_2"] --> s_2["s_2"]
139139
```
140+
141+
142+
## References
143+
144+
- Herbert E. Rauch, F. Tung, and Charles T. Striebel. 1965. Maximum likelihood estimates of linear dynamic systems. *AIAA Journal*, 3(8):1445–1450.
145+
- Michèle Giry. 1982. A categorical approach to probability theory. In Bernhard Banaschewski, editor, *Categorical Aspects of Topology and Analysis*, volume 915 of *Lecture Notes in Mathematics*, pages 68–85. Springer, Berlin, Heidelberg.
146+
- Rudolf E. Kalman. 1960. A new approach to linear filtering and prediction problems. *Journal of Basic Engineering*, 82(1):35–45.

docs/examples/lstm-lm.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -184,3 +184,9 @@ print(f"divergences: {int(result.divergence_counts.sum())}")
184184
## Categorical Perspective
185185

186186
The cell program denotes a Kleisli morphism $\mathrm{Embedded} \times \mathrm{Hidden} \to \mathcal{G}(\mathrm{Hidden})$ in the Kleisli category of the [Giry monad](https://doi.org/10.1007/BFb0092872); `scan(lstm_cell)` is its iterated composition over the sequence. The Categorical head closes the composite with a finite-set codomain, and `observe next_token` accumulates per-batch categorical log-likelihood through a [right Kan extension](https://ncatlab.org/nlab/show/Kan+extension).
187+
188+
189+
## References
190+
191+
- Michèle Giry. 1982. A categorical approach to probability theory. In Bernhard Banaschewski, editor, *Categorical Aspects of Topology and Analysis*, volume 915 of *Lecture Notes in Mathematics*, pages 68–85. Springer, Berlin, Heidelberg.
192+
- Sepp Hochreiter and Jürgen Schmidhuber. 1997. Long short-term memory. *Neural Computation*, 9(8):1735–1780.

0 commit comments

Comments
 (0)