Repository navigation
Phase 2 tidy-up: revert intersphinx-qualified references once their target lectures are translated #173
Description
Activity
2026-07-19 audit — inventory validation, plus English-pointing refs in other series
Re-audited after today's first merge batch (8 wave PRs merged). The
intermediate:table above is confirmed accurate and complete: every target resolves as astd:docentry in the live https://python.quantecon.org/objects.inv, all 8 targets are confirmed absent from this repo (untranslated), and a scan of main plus all 69 openresync/*branches found no additionalintermediate:doc refs beyond those listed.Three further English-pointing refs exist in other series and aren't in the table. Same Phase 2 logic applies, though these revert only if/when a zh-cn edition of the target series exists, so they may be long-term residents:
Referencing file Qualified target Where today lectures/ak_aiyagari.md advanced:discrete_dp(×2)main (branch identical) lectures/likelihood_ratio_process.md advanced:additive_functionalsmain (branch identical) lectures/likelihood_ratio_process_2.md advanced:additive_functionalsmain (branch identical) lectures/wealth_dynamics.md jax:wealth_dynamicsresync branch only (not yet merged) All three targets validate against their live inventories (python-advanced.quantecon.org, jax.quantecon.org).
Intersphinx config health: all 11 inventories in
_config.ymlare reachable and serving validobjects.invfiles. One nit — thetools:mapping points at https://quantecon.github.io/lecture-tools-techniques/ which now 301-redirects to https://tools-techniques.quantecon.org/. Sphinx follows the redirect so builds work today, but the mapping should move to the canonical URL when_config.ymlis next touched.Audit command covering all external series:
grep -rnE '\{(doc|ref)\}`[^`]*(intermediate|advanced|tools|pyprog|dle|dps|eqm|stats|dynam|jax):' lectures/*.mdThe 2026-08-20 full-corpus audit (project-translation#50) enumerated this class mechanically: 16
intermediate:-qualified{doc}references across 7 lectures, and every target now exists in the edition — so the whole tidy-up is actionable today. Withlearning_approximation(#261) andmccall_risk(#264) seeded, nothing is left waiting on a translation.Lecture Refs Targets ifp_egm.md6 ifp_discrete,ifp_opi,os_egm_jax,ifp_egm_transient_shocks,os_time_iter,os_egmmccall_fitted_vfi.md4 mccall_model_with_sep_markov(×4)ifp_advanced.md2 ifp_egm_transient_shocks,os_egmkalman.md1 kalman_filter_varkalman_2.md1 kalman_filter_varmccall_persist_trans.md1 mccall_model_with_sep_markovos_numerical.md1 os_time_iterBecause
_config.ymlmapsintermediate:to the English site, each of these sends a Chinese reader to python.quantecon.org for a lecture one click away locally. None of the seven files is in the #266 drift set exceptmccall_persist_trans(H1-only change there), so the sweep is safe to run now; prose-only, no cache run needed.
Generated by Claude Code
During the 2026-07-18 Track B wave, seven resynced lectures referenced lectures that exist only in the English source. Per program decision (Matt, 2026-07-18), those
{doc}references were qualified with theintermediate:intersphinx prefix so they resolve to python.quantecon.org until the targets are translated. When Phase 2 lands each target lecture here, the qualified references should revert to plain local refs — a routinetranslate forwardresync of the referencing file will do this automatically, since the source uses local refs; this issue is the checklist to make sure none are forgotten.intermediate:ifp_egm_transient_shocks,intermediate:os_egmintermediate:ifp_discrete,intermediate:ifp_opi,intermediate:ifp_egm_transient_shocks,intermediate:os_egm,intermediate:os_egm_jax,intermediate:os_time_iterintermediate:kalman_filter_varintermediate:kalman_filter_varintermediate:mccall_model_with_sep_markovintermediate:mccall_model_with_sep_markovintermediate:os_time_iterOne related non-doc case: ifp_egm.md's
{eq}eqvfs`` (a label defined in the untranslated ifp_discrete.md upstream) was pointed at the local, mathematically-identicaleqvfs_egminstead, since `{eq}` cannot cross projects. When ifp_discrete is translated, a resync will restore the upstream form. (The upstream source referencing the remote label while the local twin sits ten lines above the sentence looks like a source-side oddity — may be worth an upstream nit.)Grep to audit at any time:
grep -rn 'intermediate:' lectures/*.md