Skip to content

docs: deepen the README note demo - #100

Merged
917Dhj merged 1 commit into
developfrom
docs/demo-sol
Nov 9, 2026
Merged

917Dhj merged 1 commit into
developfrom
docs/demo-sol

Conversation

@917Dhj

@917Dhj 917Dhj commented Nov 9, 2026

Copy link
Copy Markdown
Owner

Summary

 assets/
-├── demo-note.en.webp      # 38.5 s, terra note, 12 stops, ~10 MB
-└── demo-note.zh-CN.webp
+├── demo-note.en.webp      # 45.5 s, gpt-6.1-sol note, 14 stops, 14.6 MB
+└── demo-note.zh-CN.webp   # 13.5 MB

The README demo now shows a gpt-6.1-sol note on Attention Is All You Need instead of a gpt-6.1-terra one. The middle of the note, where the depth is, now carries:

  • the three-line attention / multi-head formula, the positional-encoding formula, and the learning-rate schedule
  • the base vs big configuration table and the three-attention table
  • the full Table 2 (BLEU and training FLOPs), plus the 41.8 vs 41.0 inconsistency
  • ten rows of Table 3, including the label-smoothing PPL-vs-BLEU result
  • the Table 1 complexity comparison

Two new in-page tags were added for the extra stops: "The easy-to-miss details, explained" and "Surprising results included".

Evidence

  • Before: terra note content: shorter tables, a single attention formula, no training recipe formula
  • After: every number shown was checked against evals/papers/arxiv-transformer.pdf (Table 2, the ten Table 3 rows, optimizer and schedule, base/big configs, dropout, checkpoint averaging, Table 1). Encoded at 1440px q72 with -kmin 2 -kmax 3, the same settings that fixed the ghosting in docs: add the animated note demo to the README #99.

Merge Danger

Door: two-way

Blast Radius: README

Only the two demo images change. They are larger than before (13.5 / 14.6 MB vs ~10 MB), so the README loads a little more slowly.

🤖 Generated with Claude Code

Rebuild both demo animations from a gpt-6.1-sol note on the Transformer
paper, checked against the original PDF: full Table 2, ten Table 3 rows,
three-line attention formula, positional and learning-rate formulas, the
model configuration table, and the complexity table.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@917Dhj
917Dhj merged commit 7db4ef7 into develop Nov 9, 2026
3 checks passed
@917Dhj
917Dhj deleted the docs/demo-sol branch November 9, 2026 07:58
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant