DOC: Primary source mapping for all lecture files

[mmcky]

Lecture Source Mapping

Each lecture .md file in lecture-dp originates from one of three source repositories. This issue documents that mapping for future maintenance.

Source: lecture-python.myst (27 files)

File	Section
career.md	Job Search
cross_product_trick.md	LQ Control
ifp_advanced.md	Income Fluctuation Problems
ifp_discrete.md	Income Fluctuation Problems
ifp_egm.md	Income Fluctuation Problems
ifp_egm_transient_shocks.md	Income Fluctuation Problems
ifp_opi.md	Income Fluctuation Problems
inventory_q.md	Markov Decision Processes (pending #21)
jv.md	Job Search
lagrangian_lqdp.md	LQ Control
lq_inventories.md	LQ Control
lqcontrol.md	LQ Control
mccall_fitted_vfi.md	Job Search
mccall_model.md	Job Search
mccall_model_with_sep_markov.md	Job Search
mccall_model_with_separation.md	Job Search
mccall_persist_trans.md	Job Search
mccall_q.md	Job Search
odu.md	Job Search
os.md	Optimal Savings
os_egm.md	Optimal Savings
os_egm_jax.md	Optimal Savings
os_numerical.md	Optimal Savings
os_stochastic.md	Optimal Savings
os_time_iter.md	Optimal Savings
perm_income.md	LQ Control
perm_income_cons.md	LQ Control
rs_inventory_q.md	Markov Decision Processes (pending #21)

Source: lecture-python-advanced.myst (19 files)

File	Section
amss.md	Dynamic Programming Squared
amss2.md	Dynamic Programming Squared
amss3.md	Dynamic Programming Squared
calvo.md	Dynamic Programming Squared
calvo_abreu.md	Dynamic Programming Squared
calvo_machine_learn.md	Dynamic Programming Squared
chang_credible.md	Dynamic Programming Squared
chang_ramsey.md	Dynamic Programming Squared
cons_news.md	Advanced LQ Control
discrete_dp.md	Introduction
dyn_stack.md	Dynamic Programming Squared
lqramsey.md	Advanced LQ Control
markov_jump_lq.md	Advanced LQ Control
opt_tax_recur.md	Dynamic Programming Squared
smoothing.md	Advanced LQ Control
smoothing_tax.md	Advanced LQ Control
tax_smoothing_1.md	Advanced LQ Control
tax_smoothing_2.md	Advanced LQ Control
tax_smoothing_3.md	Advanced LQ Control
un_insure.md	Dynamic Programming Squared

Source: lecture-python-intro (1 file)

File	Section
short_path.md	Introduction

Notes

• 6 files have intentional differences from their sources due to intersphinx cross-reference prefixes (intermediate:, advanced:) that are needed in lecture-dp but not in the source repos: cons_news.md, lqcontrol.md, mccall_model_with_sep_markov.md, os.md, perm_income.md, perm_income_cons.md
  • short_path is a local lecture in lecture-dp, so references to it use the bare target short_path rather than the source repos' external intro:short_path prefix. This affects lqcontrol.md (×2) and os.md (×1). When re-syncing these files from source, change intro:short_path back to short_path.
  • lqcontrol.md also keeps an intermediate:kalman prefix; mccall_model_with_sep_markov.md keeps intermediate:finite_markov; perm_income.md keeps intermediate:linear_models/intermediate:kalman; perm_income_cons.md keeps intermediate:linear_models/intermediate:aiyagari; cons_news.md keeps advanced:classical_filtering/advanced:hs_invertibility_example; lagrangian_lqdp.md keeps intermediate:re_with_feedback.
• Files not sourced externally: intro.md, status.md, zreferences.md (these are specific to lecture-dp)
• Audit performed: March 2026; re-synced and re-audited May 2026 (lagrangian_lqdp.md + the AMSS/Calvo/opt_tax_recur group brought up to date; short_path cross-references localized in lqcontrol.md and os.md; un_insure.md re-synced to include Humphrey's max(0,…) clamp from lecture-python-advanced.myst#327; inventory_q.md and rs_inventory_q.md added from lecture-python.myst per TASK: reorder lectures #4; chang_ramsey.md and short_path.md re-synced for upstream format/typo updates).