QuantEcon / QuantEcon/lecture-python-programming

[python_by_example] While-loop description inverts the loop condition

Đang mở Phù hợp với người mới
#599 0 bình luận 0 reaction 0 người được giao Xem trên GitHub

Chưa có ai nhận issue này.

Ngôn ngữ chính
JavaScript
Star
72
Fork
31
Merge trung bình
2 ngày 20 giờ
Pull request đã merge (30 ngày)
8

Mô tả

In the "While loops" section, python_by_example.md currently reads:

A while loop will keep executing the code block delimited by indentation until the condition (i < ts_length) is satisfied.

The logic is inverted: a while loop executes the block while the condition is true, and stops once it fails. As written, "until the condition is satisfied" describes a loop that runs while i < ts_length is false.

Suggested wording:

A while loop will keep executing the code block delimited by indentation as long as the condition (i < ts_length) is true.

This matches the sentence that follows ("the program will keep adding values to the list until i equals ts_length"), which is stated correctly.

Found during native-editor review of the French edition — the machine translation had faithfully reproduced the inverted sentence, and the editor corrected it target-side in QuantEcon/lecture-python-programming.fr#25. Until it is corrected here, the French edition deliberately diverges from the source on this sentence. Same discovery path as #594.

Hướng dẫn đóng góp

Chưa lập chỉ mục được hướng dẫn đóng góp cho kho mã nguồn này

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Hướng nghiên cứu

Mở python_by_example.md và tìm phần “While loops”. Thay thế phần mô tả bị đảo ngược để mô tả rằng khối lệnh chạy miễn là điều kiện (i < ts_length) là đúng, sau đó kiểm tra câu tiếp theo để bảo đảm cách diễn đạt nhất quán và xem lại tài liệu đã được render.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Đánh giá

Công nghệ
python
Lĩnh vực
documentation
Loại issue
Tài liệu
Độ khó
1/5
Thời gian dự kiến
Dưới một giờ
Mức độ hoạt động
Ít trao đổi
Độ rõ ràng
Đặc tả rõ ràng
Mức phù hợp với người mới
92/100

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.