Summary#

  • Audit date: 2026-05-28

  • Lectures audited: 62

  • Categories audited: writing, math, code, figures, references, links, admonitions (JAX out of scope per series instructions)

  • Average overall score: 7.0 / 10

  • Average per-category scores: writing 8.2, math 5.6, code 7.0, figures 6.5, references 7.9, links 7.5, admonitions 7.8 (N/A categories excluded from each average)

Priority distribution#

Priority

Count

%

HIGH

6

10%

MEDIUM

27

44%

LOW

25

40%

NONE

4

6%

Top systemic issues across the series#

  1. [qe-fig-005] — Figures lack descriptive :name: fig-... fields for {numref} cross-referencing — appears in 45 / 62 lectures.

  2. [qe-code-002] — Spelled-out Greek (alpha, beta, gamma, …) in code parameters instead of unicode (α, β, γ) — appears in 35 / 62 lectures.

  3. [qe-math-010 (proposed)] — Bare E_t / E_0 / E[...] for expectation instead of \mathbb{E} — appears in 26 / 62 lectures.

  4. [qe-writing-005] — Decorative bolding for non-definition keywords (should use italics) — appears in 25 / 62 lectures.

  5. [qe-fig-001] — figsize= set without justification — appears in 24 / 62 lectures.

  6. [qe-math-011 (proposed)] — \mathcal{N} / \cal N / \mathcal N used as the Normal distribution instead of plain N — appears in 18 / 62 lectures.

  7. [qe-fig-003] — ax.set_title() embedding titles in matplotlib — appears in 18 / 62 lectures.

  8. [qe-link-002] — Raw python.quantecon.org / python-intro.quantecon.org / python-programming.quantecon.org URLs instead of {doc} with intersphinx prefix — appears in 17 / 62 lectures.

  9. [qe-math-002] — Prime ', ^\prime, or ^T used as transpose instead of ^\top — appears in 16 / 62 lectures.

  10. [qe-math-003] — \begin{array}, \begin{matrix}, or \begin{pmatrix} used instead of \begin{bmatrix} — appears in 15 / 62 lectures.

  11. [qe-ref-001] — Narrative “Author (Year) {cite}” patterns that should use {cite:t} — appears in 12 / 62 lectures.

  12. [qe-fig-002] — Static {figure} PNG references that could be code-generated — appears in 10 / 62 lectures.

  13. [qe-writing-001] — Multi-sentence paragraphs that should be split — appears in 15 / 62 lectures.

Lectures ranked by priority (lowest score first)#

#

Lecture

Writing

Math

Code

Fig

Ref

Link

Adm

Overall

Priority

1

hs_recursive_models

6

2

N/A

N/A

7

4

N/A

4.7

HIGH

2

robustness

7

2

7

6

7

3

N/A

4.9

HIGH

3

black_litterman

7

2

5

4

8

6

N/A

5.0

HIGH

4

knowing_forecasts_of_others

6

3

6

3

7

8

N/A

5.0

HIGH

5

classical_filtering

7

2

N/A

N/A

7

8

7

5.6

HIGH

6

calvo_machine_learn

8

2

8

8

8

9

N/A

6.0

HIGH

7

markov_jump_lq

7.5

3.5

6

4

7

8

N/A

5.7

MEDIUM

8

asset_pricing_lph

7

4

7

N/A

7

5

7

5.9

MEDIUM

9

entropy

7

4

N/A

7

8

6

N/A

5.9

MEDIUM

10

lucas_asset_pricing_dles

7

4

8

7

7

8

N/A

6.0

MEDIUM

11

additive_functionals

8

4

6

6

7

6

7

6.4

MEDIUM

12

cattle_cycles

8

4

7

6

8

8

N/A

6.4

MEDIUM

13

cons_news

7

4

7

N/A

8

7

N/A

6.4

MEDIUM

14

doubts_or_variability

8

4

6

6

9

8

8

6.4

MEDIUM

15

dyn_stack

8

5

6

5

7

6

N/A

6.4

MEDIUM

16

lu_tricks

7.5

4.5

7

7

7

8

7

6.4

MEDIUM

17

orth_proj

8

3

8

6

9

9

9

6.4

MEDIUM

18

permanent_income_dles

8

4

8

8

7

8

N/A

6.4

MEDIUM

19

risk_aversion_or_mistaken_beliefs

8

4

6

4

9

8

8

6.4

MEDIUM

20

rob_markov_perf

8

4

5

7

8

8

N/A

6.4

MEDIUM

21

smoothing_tax

8

5

7

6

7

8

7

6.4

MEDIUM

22

hs_invertibility_example

8

4

8

7

8

8

N/A

6.5

MEDIUM

23

BCG_incomplete_mkts

7.5

6

7

7

8

8

N/A

6.6

MEDIUM

24

growth_in_dles

8

4

7

7

7

8

N/A

6.6

MEDIUM

25

lqramsey

8

5

7

7

8

8

7

6.6

MEDIUM

26

match_transport

8

7

6

3

8

7

N/A

6.6

MEDIUM

27

smoothing

8

6

7

7

8

8

N/A

6.6

MEDIUM

28

tax_smoothing_2

8

5

7

6

8

8

N/A

6.6

MEDIUM

29

tax_smoothing_3

8

5

8

7

8

8

N/A

6.6

MEDIUM

30

five_preferences

7.5

6.5

6

5

8

9

N/A

6.8

MEDIUM

31

muth_kalman

8

6

7

5

7

8

N/A

6.8

MEDIUM

32

tax_smoothing_1

8

5

8

8

7

8

N/A

6.8

MEDIUM

33

discrete_dp

8.5

7.5

5

6

8

4

N/A

7.0

MEDIUM

34

BCG_complete_mkts

8

7

7

7

8

6

N/A

7.1

LOW

35

amss2

8.5

6.5

7

7

7

8

N/A

7.2

LOW

36

amss

8.5

6.5

8

7

7

8

7

7.4

LOW

37

amss3

8.5

6.5

7

7

7

8

N/A

7.4

LOW

38

dovis_accounting_mf

9

7

7

5

9

8

8

7.4

LOW

39

gorman_heterogeneous_households

7

7

7

8

9

9

N/A

7.4

LOW

40

hansen_richard_1987

9

6

6

7

9

8

10

7.4

LOW

41

irfs_in_hall_model

8

6

7

8

8

8

N/A

7.4

LOW

42

rosen_schooling_model

8.5

7.5

8

7

8

8

N/A

7.4

LOW

43

stationary_densities

9

8

7

6

8

4

8

7.4

LOW

44

calvo

9

8

7

7

8

6

N/A

7.6

LOW

45

hansen_jagannathan_1991

9

6

6

7

9

8

8

7.6

LOW

46

opt_tax_recur

9

7

7

6

8

8

N/A

7.6

LOW

47

cagan_rational_expectations

9

7

8

8

9

8

8

7.7

LOW

48

info_projection

9

6

7

8

9

8

8

7.7

LOW

49

estspec

9

8

6

5

8

9

8

7.8

LOW

50

matsuyama

9

9

7

6

8

6

8

7.8

LOW

51

troubleshooting

8.5

N/A

N/A

8

N/A

7

N/A

7.8

LOW

52

arma

9

8

6

7

8

7

N/A

7.9

LOW

53

un_insure

8.5

7.5

8

7

8

9

N/A

7.9

LOW

54

chang_ramsey

9

8

6

6

8

9

N/A

8.0

LOW

55

arellano

9

9

8

6

8

9

8

8.1

LOW

56

lucas_model

9

8

8

7

8

6

8

8.1

LOW

57

chang_credible

9

8

7

8

8

9

N/A

8.2

LOW

58

calvo_abreu

9

9

7

8

8

8

N/A

8.4

LOW

59

coase

9.5

8.5

8

7

8

9

8

8.7

NONE

60

intro

9.5

N/A

N/A

N/A

N/A

N/A

N/A

9.5

NONE

61

status

9.5

N/A

9

N/A

N/A

N/A

N/A

9.5

NONE

62

zreferences

10

N/A

N/A

N/A

10

N/A

N/A

10.0

NONE

Series-level recommendations#

Writing & math issues#

  1. Mass-replace bare expectation symbols. Run a global pass converting bare E_t, E_0, E[...] to \mathbb{E}_t, \mathbb{E}_0, \mathbb{E}[...] (qe-math-010, proposed). This single fix would lift many MEDIUM lectures into LOW priority — 26 lectures affected.

  2. Eliminate transpose primes and ^T. Replace prime ', ^\prime, and ^T (when used as transpose) with ^\top across the series (qe-math-002). Be careful to preserve derivative u', f', v' and next-period notation x', B', \theta' — 16 lectures affected.

  3. Switch distribution notation. Replace \mathcal{N}, \cal N, {\mathcal N}, {\cal N} with plain N (qe-math-011, proposed) — 18 lectures affected.

  4. Convert all matrix environments. Replace \begin{array}, \begin{matrix}, \begin{pmatrix} with \begin{bmatrix} (qe-math-003). The DLE-class lectures (growth_in_dles, cattle_cycles, lucas_asset_pricing_dles, permanent_income_dles, hs_invertibility_example) all share this issue — 15 lectures affected.

  5. Reduce decorative bolding. Switch from **term** to italics (*term*) where intent is emphasis (qe-writing-005) — 25 lectures affected.

  6. Standardise “IID”. Replace “i.i.d.” and “iid” with “IID” in narrative text (qe-writing-009, proposed) — 6 lectures affected.

Notes on coverage#

  • 7 modern (post-2024) lectures are included: cagan_rational_expectations, doubts_or_variability, dovis_accounting_mf, hansen_jagannathan_1991, hansen_richard_1987, info_projection, risk_aversion_or_mistaken_beliefs. All score in the LOW-or-MEDIUM range.

  • hansen_richard_1987 is the strongest exemplar of prf:-prefixed proof directives in the series (26 {prf:...} directives) and should be referenced when remediating qe-admon-004 violations elsewhere.

  • orth_proj (18 {prf:...}) is the other exemplar.

  • JAX category is out-of-scope per series instructions; only dovis_accounting_mf and calvo_machine_learn import JAX in this series.