Skip to content

bibliography: set the 42 ruled entries to the lecture monorepo's - #875

Open
mmcky wants to merge 1 commit into
mainfrom
bibliography-pool-rulings
Open

mmcky wants to merge 1 commit into
mainfrom
bibliography-pool-rulings

Conversation

@mmcky

@mmcky mmcky commented Nov 22, 2026 •

Copy link
Copy Markdown
Contributor

What

This file holds 44 entries that a ruling covers; this sets the 42 of them that differ to the lecture monorepo's merged bibliography (QuantEcon/lectures, lectures/_static/quant-econ.bib). Each of those keys is settled there by a ruling in sync/bib.yml: the owner's rulings of 2026-11-02 (QuantEcon/project-monorepo#10), the four rules accepted on 2026-10-12, or a style fix of decision D3. On 2026-11-22 the owner asked for lecture fixes to be reported upstream to their source of truth, and chose to set every ruled entry a series holds to the pool's, cited or not ("All ruled entries (Recommended)").

It is mechanical. Each changed entry equals the pool's once both are normalised as tools/bib-merge reads them, and every other entry is untouched; a script checked both. Fields the house style leaves out (month, abstract, keywords, file, date-added, date-modified, issn) are kept as this file had them; an empty field, such as doi = {}, is dropped, as the pool's normaliser drops it. The changed entries are written in the pool's layout, one field per line.

Corrections to entries this series cites (6)

Key Why What changes (this file → the pool's)
bertsimas_tsitsiklis1997 a broken copy author: Bertsimas, D. & Tsitsiklis, J. N. → Bertsimas, Dimitris and Tsitsiklis, John N.; title: {Introduction to linear optimization} → {Introduction to Linear Optimization}
Burns_2023 a broken copy title: Milton Friedman: The Last Conservative by Jennifer Burns → Milton Friedman: The Last Conservative
hu_guo2018 a broken copy author: Hu, Y. & Guo, Y. → Hu, Yunquan and Guo, Yaohuang
pareto1896cours the owner's ruling entry type: article → book; address: (none) → Lausanne; author: Vilfredo, Pareto → Pareto, Vilfredo; journal: Rouge, Lausanne → (none); publisher: (none) → F. Rouge; volume: 2 → (none)
Samuelson1939 the owner's ruling journal: Review of Economic Studies → The Review of Economics and Statistics
sargent1989least a style fix editor: William Barnett, John Geweke, and Karl Shell → William Barnett and John Geweke and Karl Shell

The rest (36)

  • 15 not cited, the owner's ruling
  • 8 not cited, a broken copy
  • 6 not cited, the rule: one copy has more fields
  • 4 not cited, the rule: the same fact written two ways
  • 2 not cited, the rule: cosmetic differences
  • 1 not cited, a style fix

"The owner's ruling" and "a broken copy" correct the data: the wrong paper, author, year, pages or journal, or a malformed entry. "More fields" adds what another series' copy has, such as a DOI. "The same fact written two ways" and "cosmetic differences" settle on one spelling of the same data.

Validation

Done on 2026-11-22, a full validation; the evidence is in the comment below. Fresh builds with no cache of this pull request and of main, every notebook executed, both green. The only differences are the corrected citations and references, and the citation links they renumber.

This changes content, so it needs a person's review.

🤖 Generated with Claude Code

https://claude.ai/code/session_01WT8bMacV9Lmy1VLUc6XJoL

Each of these keys is settled in the lecture monorepo's merged bibliography
(QuantEcon/lectures, sync/bib.yml) by the owner's rulings of 2026-11-02,
the rules accepted on 2026-10-12 or a style fix of decision D3. On
2026-11-22 the owner asked for every ruled entry a series holds to be set
to the pool's. Each changed entry equals the pool's once both are
normalised; every other entry is untouched, and the fields the house style
leaves out (month, abstract, keywords and others) are kept as they were.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01WT8bMacV9Lmy1VLUc6XJoL
@netlify

netlify Bot commented Nov 22, 2026 •

Copy link
Copy Markdown

✅ Deploy Preview for taupe-gaufre-c4e660 ready!

Name Link
🔨 Latest commit 52ea526
🔍 Latest deploy log https://app.netlify.com/projects/taupe-gaufre-c4e660/deploys/6b02c1f7b59022b4a404263f
😎 Deploy Preview https://deploy-preview-875--taupe-gaufre-c4e660.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@github-actions

github-actions Bot commented Nov 22, 2026 •

Copy link
Copy Markdown

@github-actions
github-actions Bot temporarily deployed to pull request November 22, 2026 10:27 Inactive
@github-actions
github-actions Bot temporarily deployed to pull request November 22, 2026 10:28 Inactive
@mmcky

mmcky commented Nov 22, 2026 •

Copy link
Copy Markdown
Contributor Author

Validation: a full validation

Two fresh builds with no cache, each executing all 54 notebooks, -W --keep-going, both green:

Build Run
main at 8db8a99, this branch's base, 2026-11-22 44991424113
this pull request at 52ea526, 2026-11-22 45012261610

Build logs. The same warning lines on both sides, and no Sphinx warning on either.

Cell outputs. No code changed, so nothing executes differently. The output lines that differ, on 9 pages, are the same as between any two builds: random draws, memory addresses and timings. The warnings in the outputs are the same on both sides, intro's two existing pandas warnings (#876).

The HTML, page by page. 23 of 66 pages differ:

  • The corrected citations read differently in the text:

    • heavy_tails and wealth_tax: "Vilfredo, 1896" becomes "Pareto, 1896";
    • lp_intro: "Bertsimas, 1997" becomes "Bertsimas and Tsitsiklis, 1997", and "Hu, 2018" becomes "Hu and Guo, 2018".
  • The references page shows the corrected entries:

    • Bertsimas and Tsitsiklis's authors and title;
    • Burns's title without "by Jennifer Burns";
    • Hu and Guo's authors;
    • Pareto's Cours d'économie politique as a book (F. Rouge, Lausanne);
    • Samuelson (1939)'s journal, The Review of Economics and Statistics;
    • the editors of Marcet and Sargent's chapter.

    Their labels change with the authors (Ber97 to BT97, Hu18 to HG18, Vil96 to Par96).

  • Figure file names: on 15 pages, a figure's file name differs. A figure's file is named by its content, so an unseeded figure that is drawn again gets a new name, as between any two builds. On 10 of the pages that is the only difference. No link into the references page differs.

  • The status page: build times.

Nothing else changes.

(Corrected 2026-11-22: the link differences are figure file names, which change whenever an unseeded figure is redrawn, not citation anchors; no link into the references page differs. The conclusions are unchanged.)

@mmcky
mmcky marked this pull request as ready for review November 22, 2026 10:45
Copilot AI adaptive review requested due to automatic review settings November 22, 2026 10:45

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟡 Changes recommended

Two moderate citation issues remain: the Papoulis book entry omits co-author S. Unnikrishna Pillai, and the labor-markets paper title is incomplete.

2 open issues
What changed in this PR

This PR synchronizes 42 ruled bibliography entries in lectures/_static/quant-econ.bib with the merged QuantEcon bibliography, correcting metadata and standardizing formatting while preserving selected lecture-specific fields.

Changes:

  • Updates authors, titles, journals, publishers, entry types, and other bibliographic details.
  • Rewrites changed entries using the merged bibliography’s normalized layout.
  • Leaves unrelated bibliography entries and required lecture-specific fields unchanged.
File Description
lectures/​_static/​quant-econ.bib Synchronizes 42 ruled bibliography entries with the merged QuantEcon bibliography and updates their bibliographic metadata and formatting.

Review effort: Lite (adaptive)

title = {Probability, random variables, and stochastic processes},
author = {Athanasios, Papoulis and Pillai, S Unnikrishna},
publisher = {Mc-Graw Hill},
author = {Papoulis, Athanasios},

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Not changed: the new entry is right. The 1991 edition, the third, of Probability, Random Variables, and Stochastic Processes (McGraw-Hill) is by Athanasios Papoulis alone. S. Unnikrishna Pillai joined as co-author at the fourth edition, in 2002. The old entry also had Papoulis's names swapped ("Athanasios, Papoulis"). This is the owner's ruling of 2026-11-02 on the lecture monorepo's merged bibliography, which this pull request brings to intro.

title = {The flow approach to labor markets: New data sources, micro-macro links and the recent downturn},
author = {Davis, Steven J and Faberman, R Jason and Haltiwanger, John},
author = {Davis, Steven J. and Faberman, R. Jason and Haltiwanger, John},
title = {The Flow Approach to Labor Markets: New Data Sources and Micro-Macro Links},

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Not changed: the new title is the published one. "The Flow Approach to Labor Markets: New Data Sources, Micro-Macro Links and the Recent Downturn" is the title of the NBER working paper (w12167). The article in the Journal of Economic Perspectives 20(3), 3–26 (2006), which this entry cites by journal, volume and pages, is "The Flow Approach to Labor Markets: New Data Sources and Micro-Macro Links". This is the owner's ruling of 2026-11-02 on the lecture monorepo's merged bibliography, which this pull request brings to intro.

This branch was previously deployed

1 inactive deployment
pull request — 52ea5268 Deployed Nov 22, 2026 by github-actions[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants