QuantEcon / QuantEcon/lecture-python-programming
[python_by_example] While-loop description inverts the loop condition
Ninguém assumiu esta issue ainda.
- Linguagem predominante
- JavaScript
- Estrelas
- 72
- Forks
- 31
- Merge médio
- 2d 20h
- PRs com merge (30d)
- 8
Descrição
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.
Guia de contribuição
Nenhum guia de contribuição indexado para este repositório
Primeiros passos
- Leia a issue inteira e depois o guia de contribuição do projeto.
- Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
- Faça um fork do repositório e trabalhe em uma branch.
- Abra um pull request que referencie o número da issue.
Direção de pesquisa
Abra python_by_example.md e encontre a seção “While loops”. Substitua a descrição invertida para que ela diga que o bloco é executado enquanto a condição (i < ts_length) for verdadeira; em seguida, verifique se a redação da frase seguinte é consistente e revise a documentação renderizada.
Escrita pelo modelo de indexação a partir do texto da issue.
Avaliação
- Stack de tecnologia
- python
- Domínio
- documentation
- Tipo de issue
- Documentação
- Dificuldade
- 1/5
- Tempo estimado
- Menos de uma hora
- Status de atividade
- Pouca atividade
- Clareza
- Claramente especificada
- Facilidade para iniciantes
- 92/100