QuantEcon / QuantEcon/lecture-python.zh-cn
Phase 2 tidy-up: revert intersphinx-qualified references once their target lectures are translated
Nobody has claimed this yet.
- Dominant language
- TeX
- Stars
- 5
- Forks
- 4
- Avg merge
- 14h 55m
- Merged PRs (30d)
- 9
Description
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 the intermediate: 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 routine translate forward resync 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.
| Referencing file | Qualified targets |
|---|---|
| lectures/ifp_advanced.md | intermediate:ifp_egm_transient_shocks, intermediate:os_egm |
| lectures/ifp_egm.md | intermediate:ifp_discrete, intermediate:ifp_opi, intermediate:ifp_egm_transient_shocks, intermediate:os_egm, intermediate:os_egm_jax, intermediate:os_time_iter |
| lectures/kalman.md | intermediate:kalman_filter_var |
| lectures/kalman_2.md | intermediate:kalman_filter_var |
| lectures/mccall_fitted_vfi.md | intermediate:mccall_model_with_sep_markov |
| lectures/mccall_persist_trans.md | intermediate:mccall_model_with_sep_markov |
| lectures/os_numerical.md | intermediate:os_time_iter |
One 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-identical eqvfs_egm instead, 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
Contributor guide
No contributing guide indexed for this repository
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start with the checklist in the issue and run grep -rn 'intermediate:' lectures/*.md to audit the listed lecture files. After the target lectures are translated, resync each referencing file with translate forward; done means the qualified references are restored to plain local references and the related eqvfs reference is restored by resync.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- markdown
- Domain
- documentation, localization
- Issue type
- Documentation
- Difficulty
- 2/5
- Estimated time
- 1-3 hours
- Activity status
- Active
- Clarity
- Clearly specified
- Newbie friendliness
- 76/100