QuantEcon / QuantEcon/lecture-python.zh-cn

Phase 2 tidy-up: revert intersphinx-qualified references once their target lectures are translated

Open Beginner friendly
#173 2 comments 0 reactions 0 assignees View on GitHub

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

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. 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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.