QuantEcon / QuantEcon/lecture-python-programming

[python_by_example] While-loop description inverts the loop condition

Aperta Adatta ai principianti
#599 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

Nessuno ha ancora preso questa issue.

Lingua principale
JavaScript
Stelle
72
Fork
31
Merge medio
2g 20h
PR unite (30g)
8

Descrizione

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.

Guida per i contributori

Nessuna guida per i contributori indicizzata per questo repository

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Direzione di ricerca

Apri python_by_example.md e trova la sezione “While loops”. Sostituisci la descrizione invertita in modo che dica che il blocco viene eseguito finché la condizione (i < ts_length) è vera, quindi controlla che la formulazione della frase seguente sia coerente e rivedi la documentazione renderizzata.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Valutazione

Stack tecnologico
python
Ambito
documentation
Tipo di issue
Documentazione
Difficoltà
1/5
Tempo stimato
Meno di un'ora
Stato di attività
Tranquilla
Chiarezza
Specificata chiaramente
Idoneità per principianti
92/100

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.