python / python/python-docs-pt-br
Melhoria na tradução do texto sobre `iter`, capítulo "Funções embutidas"
Nobody has claimed this yet.
- Dominant language
- Python
- Stars
- 164
- Forks
- 42
- Avg merge
- 14h 32m
- Merged PRs (30d)
- 4
Description
Na documentação de iter o termo "block-reader" foi traduzido como "bloco de leitura". Porém, pelo contexto, uma tradução melhor seria "leitor de blocos" ou mesmo "leitor bloco-a-bloco" (não literal, mais descritivo do comportamento)
O último parágrafo está assim:
Uma aplicação útil da segunda forma de iter() é para construir um bloco de leitura. Por exemplo, ler blocos de comprimento fixo de um arquivo binário de banco de dados até que o final do arquivo seja atingido:
Em inglês:
One useful application of the second form of iter() is to build a block-reader. For example, reading fixed-width blocks from a binary database file until the end of file is reached:
A proposta é trocar "bloco de leitura" por "leitor bloco-a-bloco (block reader)"
Outra sugestão é incluir a palavra "para" na segunda sentença: "Por exemplo, para ler blocos..."
Contributor guide
No contributing guide indexed for this repository
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Open the linked Python documentation page and locate the iter entry in the “Funções embutidas” chapter, especially its final paragraph. Update the Portuguese wording for “block-reader” and consider the suggested “para” in the next sentence; done means the rendered translation matches the accepted wording.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- python
- Domain
- documentation, localization
- Issue type
- Documentation
- Difficulty
- 1/5
- Estimated time
- Under an hour
- Activity status
- Stale
- Clarity
- Clearly specified
- Newbie friendliness
- 50/100