Skip to content

Commit fadec1e

Browse files
committed
docs: synchronize missing English translations
1 parent 6ed0bc2 commit fadec1e

12 files changed

Lines changed: 288 additions & 133 deletions

File tree

docs/.vitepress/config.mjs

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1819,7 +1819,7 @@ const enSidebar = {
18191819
items: [
18201820
{
18211821
text: '9.1 Deterministic Policy Gradients and DDPG',
1822-
link: '/en/chapter11_continuous_control/deterministic-policy-gradient-ddpg'
1822+
link: '/en/chapter11_continuous_control/ddpg'
18231823
},
18241824
{
18251825
text: '9.2 TD3 and SAC',
@@ -2366,8 +2366,8 @@ const enSidebar = {
23662366
collapsed: false,
23672367
items: [
23682368
{
2369-
text: 'C.1 Paper Reading Guide',
2370-
link: '/en/appendix_paper_reading/paper-reading-guide'
2369+
text: 'C.1 Learning Resources and Project Roadmap',
2370+
link: '/en/appendix_paper_reading/learning-resources'
23712371
},
23722372
{
23732373
text: 'C.2 GPU Hours Estimation Table',

docs/en/appendix_gpu_hours/gpu-hours-estimation.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -186,7 +186,7 @@ Suitable for learning the full process of RLHF/RLVR/DPO, and can complete a full
186186

187187
- Reproduce the training curves of R1-Zero on GSM8K using GRPO ([Chapter 18](../chapter18_grpo/grpo-practice-and-mechanism))
188188
- Fine-tune on Anthropic HH-RLHF data using DPO ([Chapter 14](../chapter17_dpo/dpo-objective-derivation))
189-
- Run SAC/TD3 on CartPole / MuJoCo ([Chapter 9](../chapter11_continuous_control/deterministic-policy-gradient-ddpg))
189+
- Run SAC/TD3 on CartPole / MuJoCo ([Chapter 9](../chapter11_continuous_control/ddpg))
190190
:::
191191

192192
### Multi-GPU Experiments (7B–13B Models)
@@ -301,4 +301,4 @@ Next Steps Recommendation:
301301

302302
- **Do a Baseline Experiment**: Refer to the GRPO/DPO code in [Appendix D Code Quick Reference](../appendix_code_cheatsheet/sft-kl) and run it on a single GPU.
303303
- **Plan a Mid-Scale Experiment**: Refer to the distributed training and monitoring sections in [Appendix B Engineering Practices](../appendix_industrial_training/training-debugging).
304-
- **Read the Cost Disclosure in Frontier Papers**: Look for training details in the tech reports in [Appendix F](../appendix_paper_reading/paper-reading-guide).
304+
- **Read the Cost Disclosure in Frontier Papers**: Look for training details in the tech reports in [Appendix C](../appendix_paper_reading/learning-resources).

docs/en/appendix_paper_reading/paper-reading-guide.md renamed to docs/en/appendix_paper_reading/learning-resources.md

Lines changed: 20 additions & 20 deletions
Large diffs are not rendered by default.

docs/en/chapter03_mdp/value-q.md

Lines changed: 16 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -362,17 +362,29 @@ The shortest path from S to G hugs the cliff edge and takes 11 steps. But it is
362362
<em>Source: <a href="https://gymnasium.farama.org/environments/toy_text/cliff_walking/" target="_blank" rel="noopener noreferrer">Gymnasium Documentation - Cliff Walking</a>. The original environment is adapted from Sutton and Barto, <em>Reinforcement Learning: An Introduction</em>, Example 6.6.</em>
363363
</p>
364364

365-
**Q-Learning** (off-policy) uses $\max_{a'} Q(s',a')$ in its target, which assumes that the future always takes the optimal action. Therefore it learns the shortest cliff-hugging path.
365+
The two algorithms behave differently in CliffWalking because one term in their update targets is different.
366366

367-
**SARSA** (on-policy) uses the target $r + \gamma Q(s', a')$, where $a'$ is the action actually sampled from the current behavior policy (typically $\varepsilon$-greedy). Since SARSA accounts for the risk of exploration-induced mistakes inside its update, it tends to learn a safer path away from the cliff, even if it is longer.
367+
**Q-Learning** uses
368+
369+
$$
370+
Q(s,a) \leftarrow Q(s,a) + \alpha\left[r + \gamma\max_{a'}Q(s',a') - Q(s,a)\right].
371+
$$
372+
373+
Its target is $r+\gamma\max_{a'}Q(s',a')$. Regardless of which next action the behavior policy actually executes, Q-Learning uses the largest Q-value in $s'$. It therefore assumes that the next step will execute the optimal action perfectly. The resulting policy follows the shortest path beside the cliff without accounting for the risk that exploration may move the agent downward.
374+
375+
**SARSA** uses
376+
377+
$$
378+
Q(s,a) \leftarrow Q(s,a) + \alpha\left[r + \gamma Q(s',a') - Q(s,a)\right].
379+
$$
380+
381+
Its target is $r+\gamma Q(s',a')$, where $a'$ is the action actually sampled from the current $\varepsilon$-greedy policy. Because SARSA learns from the next action that the behavior policy really selected, its update includes the risk of exploration-induced mistakes. It therefore tends to learn a longer but safer path away from the cliff.
368382

369383
The difference between the two algorithms comes from different assumptions about “the future policy”:
370384

371385
- Q-Learning estimates the value of the **optimal policy**, independent of how the current behavior policy explores.
372386
- SARSA estimates the value of the **current behavior policy**, so it avoids risks introduced by exploration.
373387

374-
This is not a question of which one is “better”. They answer different questions. Q-Learning answers “if we ignore the randomness of exploration, what is the ideal optimum?SARSA answers “given the exploration noise we are actually using, what is the safest way to behave?”.
375-
376388
<span id="limitations"></span>
377389

378390
## Limitations of Tabular Methods

docs/en/chapter07_dqn/visual-game-projects.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -339,7 +339,7 @@ Observations must also be sufficient for decision-making. The current frame or f
339339

340340
Rewards must arrive within a reasonable time. DQN propagates future returns step-by-step through the TD target. If the replay buffer contains only negative samples or meaningless transitions for a long time, the network cannot know which early action was useful. This is not a formula error — it is the learning signal being too far from the action.
341341

342-
Finally, ε-greedy exploration must be able to produce useful experience. When action combinations are too many, episodes too long, and failure feedback too late, random exploration may fail to collect meaningful samples for a long time. In such cases, reducing the action set, designing staged rewards, or switching to methods better suited for long-horizon exploration is needed.
342+
Finally, $\epsilon$-greedy exploration must be able to produce useful experience. When action combinations are too many, episodes too long, and failure feedback too late, random exploration may fail to collect meaningful samples for a long time. In such cases, reducing the action set, designing staged rewards, or switching to methods better suited for long-horizon exploration is needed.
343343

344344
Not meeting these conditions does not mean DQN completely fails — it means additional design is needed: continuous actions require different algorithms, missing observations require memory, sparse rewards require engineering or task decomposition.
345345

0 commit comments

Comments
 (0)