Skip to content

docs(training): thân bài chỉ tả code hiện tại, lịch sử vào khối 📜 (GĐ4 phần 1) - #37

Merged
Tmphi merged 1 commit into
mainfrom
docs/present-tense
Oct 16, 2026
Merged

Tmphi merged 1 commit into
mainfrom
docs/present-tense

Conversation

@Tmphi

@Tmphi Tmphi commented Oct 16, 2026

Copy link
Copy Markdown
Owner

GĐ4, phần 1. Người mới đọc T02 hay U01 phải lội qua hàng chục ghi chú "trên v1.0.0…", "từ PR #6…", "trước PR #11…" lẫn trong bài. Những ghi chú đó cần cho lab sửa backlog, nhưng làm rối lần đọc đầu. PR này gom chúng vào khối thu gọn.

Quy ước (training/README §5 và §7)

  • Thân bài chỉ tả code hiện tại.
  • Mô tả code cũ đặt vào <details><summary>📜 Lịch sử</summary> ở cuối mục, trước khối ✅ nếu có, kèm mã B-xx và số PR.
  • Mã B-xx ngắn trong thân bài vẫn giữ, vì lab và T09 dùng chúng để tra.
  • Giữ trong thân bài: phản ví dụ có chủ đích (bảng DEMO_ASYNC_AWAIT trên v1.0.0 ở T01 §8) và mốc đo lường ("sau PR fix: GridSpec rejects NaN and infinite sizes (B-34) #13: 1.257/5.884 dòng").
  • T03, T09, T10 giữ nguyên, vì bản thân chúng là sổ tay sự cố, backlog và lab làm trên code cũ.

Đã đổi

Kiểm

  • Mỗi đoạn chuyển vào 📜 được đối chiếu với dòng tương ứng trong backlog T09 §3 (B-04, B-05, B-06, B-14, B-15, B-19, B-26, B-30, B-31…B-34), để không đổi nội dung lịch sử.
  • gh api markdown: khối 📜 hiển thị thành khối thu gọn, danh sách và code inline đúng; bảng trong khối 📜 của T02 §10 vẫn là bảng.
  • npm run links, reading-time, deck, code mẫu U01: 0 lỗi.

Phần sau của GĐ4

Mục lục theo nhiệm vụ cho T08/U03, và 3–4 hình minh họa.

🤖 Generated with Claude Code

History notes ('on v1.0.0…', 'since PR #6…', 'before PR #11…') in T02,
T08, U01 and U02 move into collapsed 📜 blocks at the end of their
sections; the body is rewritten in the present tense and keeps short
B-xx ids for labs and T09. Changelog-style PR mentions in T01 and T05
are dropped; deliberate counter-examples and measurement stamps stay.
README §5 adds the 📜 legend, §7 the maintenance rule. T03, T09 and T10
are history by nature and stay as they are.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@Tmphi
Tmphi merged commit fd1f1ad into main Oct 16, 2026
2 checks passed
@Tmphi
Tmphi deleted the docs/present-tense branch October 16, 2026 02:28
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.

2 participants