python / python/python-docs-pt-br

Melhoria na tradução do texto sobre `iter`, capítulo "Funções embutidas"

Open
#290 2 comments 0 reactions 0 assignees View on GitHub

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

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. 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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.