Issue Triage: Analysis and Action Plan (Nov 2025)

[mmcky]

Note: This is a TEMPORARY ISSUE as a place to store some planning analysis. Will close this issue soon.

GitHub Issues Analysis: lecture-python.myst

Repository: QuantEcon/lecture-python.myst
Analysis Date: 25 November 2025
Total Open Issues: 47

---

Summary by Solvability

Category	Count	Description
✅ Can Solve Now	15	Direct code/content fixes
🔧 Partially Solvable	8	Can make progress, may need human review
📋 Documentation/Historical	4	Already documented or informational
🔨 Infrastructure/External	12	Requires external packages, CI changes, or human decisions
❓ Needs Investigation	8	Requires deeper analysis or clarification

---

✅ Issues We Can Solve Now (15)

High Priority - Bug Fixes

#	Title	Effort	Notes
#739	Link Checker Report	✅ Done	Fixed in PR #743
#677	[math typo] rational_expectations	Low	Fix math typo - missing/incorrect symbol
#683	CapWords convention for class names	Low	Rename bid_price_solution → BidPriceSolution in two_auctions.md and house_auction.md
#587	Python warnings found in code output	Medium	Fix MatplotlibDeprecationWarning in samuelson.md - change positional to keyword args
#579	[samuelson] BUG: fix Matplotlib deprecation notice	Medium	Same as #587 - fix ax.scatter() call
#233	error in modeling covid19	Low	Fix (R) rendering issue in sir_model.md

Medium Priority - Content Improvements

#	Title	Effort	Notes
#713	[cake_eating_problem] Some suggestions	Low	Fix 2 typos + notation consistency
#722	STYLE: Use of Bold and Definition -- clash	Medium	Convert **Definition** to {prf:definition} directive
#449	[inventory_dynamics] update suggestions	Low	Fix "probability mass" → "probability density", update jitted terminology
#577	[mix_model] FIX: links are full web links	Medium	Convert full URLs to {doc} links
#512	[Intermediate Lecture Series] Fix Title Style	High	Large task - fix subtitle capitalization across 80+ lectures
#225	Update rand_rest and util_rand_rest equation references	Medium	Convert \tag to {eq} references

Low Priority - Code Style

#	Title	Effort	Notes
#712	minor fixes for JS III	Low	Fix magic numbers, remove extra compiled function in mccall_model_with_sep_markov.md
#496	Improvements to exchangeable lecture	Medium	Fix SyntaxWarning, improve simulate function, toggle code
#483	[kalman_2] Unclear purpose of single-worker plotting	Low	Clarify code comments, fix undefined u_0

---

🔧 Partially Solvable (8)

#	Title	What Can Be Done	What Needs Human Input
#716	[ak2] improvements + JAX conversion	Fix typo ($C_{0,t+1}$ → $C_{o,t+1}$)	JAX conversion needs review
#719	[JAX] Remove @jax.jit on intermediate functions	Audit code, propose changes	Performance testing needed
#505	convert McCall job search I to JAX	Can draft conversion	Needs verification
#559	likelihood bayes lecture issues	Fix missing `	` symbol
#252	AR1 Bayes lecture comments	Add guidance text about pymc/numpyro	Content decisions needed
#478	von Neumann lecture improvements	Show full class, remove object	Theorem/proof environments
#169	[lake_model] Comments	Can simplify code	Pedagogical decisions needed
#106	[re_with_feedback] long math outputs	Can investigate solutions	May need LaTeX expertise

---

📋 Documentation/Historical (4)

#	Title	Status
#680	Historical Record: Removal of :load: Directives	Documentation only - no action needed
#661	MAINT: HTML archive as Publish asset + set gh-pages to orphan	Detailed plan documented
#606	[maint] review move to netlify-cli	Review task after testing
#83	speed/accuracy comparisons using glue functionality	Feature request for future

---

🔨 Infrastructure/External (12)

#	Title	Why External
#653	ENH: turn PR netlify preview into action	Requires new GitHub Action development
#622	[numpyro] Add discussions on model functions	Needs NumPyro expertise
#565	Change frequency of colab CI	CI/workflow decision
#560	[theme] Implement minimal styling for sphinx-proof	Requires theme changes
#578	FIX: sphinx-proof style update -- reduce padding	Requires sphinx-proof package update
#554	BUG: get check-warnings to run on changed files only	Requires action modification
#568	[performance] GitHub Actions slower than local	Infrastructure investigation
#576	[bayes_nonconj] BUG: UserWarning	May resolve with numpyro updates
#380	pymc.sample docs incorrect	Waiting for upstream fix
#144	[windows] unicode issue when compiling	Platform-specific issue
#92	[jupyterbook-latex] letters shown mistakenly	LaTeX/jupyterbook issue
#91	[jupyterbook-latex] wrong location for figure	LaTeX/jupyterbook issue

---

❓ Needs Investigation (8)

#	Title	Investigation Needed
#308	Issues in Ex 12.2	Need to identify which lecture and verify mismatch
#459	[cass_fiscal] Inconsistency in $B^f$ Path	Mathematical verification needed
#139	[finite_markov] pdf to tikz	Scope assessment - how many figures?
#87	[jupyterbook-latex] no input/output labels	Check if still relevant
#54	external links in footnotes not working	Verify if still an issue
#53	Footnotes title missing in MYST	Verify if still an issue
#45	[Kasten_Processes] redundant_output	Verify if still an issue

---

Recommended Action Plan

Immediate (Quick wins)

1. [math typo] rational_expectations  #677 - Fix math typo in rational_expectations
2. CapWords convention for class names #683 - Fix class naming convention (PEP8)
3. Python warnings found in code output #587/[samuelson] BUG: fix Matplotlib deprecation notice #579 - Fix matplotlib deprecation in samuelson
4. [cake_eating_problem] Some suggestions #713 - Fix typos in cake_eating_problem
5. [inventory_dynamics] update suggestions #449 - Update inventory_dynamics terminology
6. error in modeling covid19 #233 - Fix (R) rendering in sir_model

Short-term (This week)

7. STYLE: Use of Bold and Definition -- clash #722 - Convert Definition to prf:definition directive
8. [mix_model] FIX: links are full web links across the lecture #577 - Fix full web links in mix_model
9. minor fixes for JS III #712 - Minor fixes for mccall_model_with_sep_markov
10. [kalman_2] Unclear purpose of single-worker plotting example code #483 - Clarify kalman_2 code

Medium-term (Requires more effort)

11. [Intermediate Lecture Series] Fix Title Style #512 - Fix title style across all lectures (large task)
12. Improvements to exchangeable lecture #496 - Improvements to exchangeable lecture
13. Update rand_rest and util_rand_rest In Text Equation References #225 - Update equation references
14. [ak2] improvements in lecture and conversion to JAX #716 - ak2 improvements (typo fix portion)

---

Quick Wins Summary

6 issues can be fixed in under 30 minutes each:

• [math typo] rational_expectations  #677, CapWords convention for class names #683, [cake_eating_problem] Some suggestions #713, [inventory_dynamics] update suggestions #449, error in modeling covid19 #233, [kalman_2] Unclear purpose of single-worker plotting example code #483

Total estimated time for quick wins: ~3 hours

---

Generated by GitHub Copilot analysis - 25 November 2025

[mmcky]

Update: Potentially Outdated Issues

After further analysis, the following 10 issues appear to be outdated and candidates for closure:

RST/MyST Migration Issues (2021) - Migration Complete

These were created during the RST → MyST migration which is now complete:

#	Title	Created	Recommendation
#45	[lecture_comparison][16_Kasten_Processes]redundant_output	2021-01-18	Close - RST comparison no longer relevant
#53	[downloadnb-comparison] Footnotes title missing	2021-01-27	Close - RST comparison no longer relevant
#54	[downloadnb-comparison] external links in footnotes	2021-01-27	Close - RST comparison no longer relevant
#87	[jupyterbook-latex] no input/output labels	2021-02-10	Close - jupyter-book has evolved significantly

LaTeX/PDF Issues (2021) - Likely Resolved

#	Title	Created	Recommendation
#91	[jupyterbook-latex] wrong figure location	2021-02-10	Close - needs verification but likely fixed
#92	[jupyterbook-latex] letters shown mistakenly	2021-02-10	Close - needs verification but likely fixed

Stale Feature Requests / External Dependencies

#	Title	Created	Recommendation
#83	speed/accuracy comparisons using glue	2020-04-05	Close - 5 years old, glue is mature now
#139	[finite_markov] pdf to tikz	2021-05-10	Close - low priority nice-to-have
#144	[windows] unicode issue	2021-06-01	Close - platform/tooling has changed
#380	pymc.sample docs incorrect	2023-12-18	Close - 2 years waiting for upstream

---

Issues to Keep Open (older but still valid)

#	Title	Created	Why Keep
#106	[re_with_feedback] long math outputs	2021-03-01	Valid display issue
#169	[lake_model] Comments	2021-07-18	Valid code improvements
#225	Update rand_resp equation references	2022-04-28	Files exist, still relevant
#233	error in modeling covid19	2022-06-15	Valid rendering issue
#252	AR1 Bayes lecture comments	2022-08-19	Valid content suggestions
#308	Issues in Ex 12.2	2023-01-16	Needs investigation

---

Summary: Closing 10 stale issues would reduce open issues from 47 to 37, making the backlog more actionable.