python / python/python-docs-pt-br

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

Aberta
#290 2 comentários 0 reações 0 responsáveis Ver no GitHub

Ninguém assumiu esta issue ainda.

Linguagem predominante
Python
Estrelas
164
Forks
42
Merge médio
14h 32min
PRs com merge (30d)
4

Descrição

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..."

Guia de contribuição

Nenhum guia de contribuição indexado para este repositório

Primeiros passos

  1. Leia a issue inteira e depois o guia de contribuição do projeto.
  2. Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
  3. Faça um fork do repositório e trabalhe em uma branch.
  4. Abra um pull request que referencie o número da issue.

Direção de pesquisa

Abra a página vinculada da documentação do Python e localize a entrada iter no capítulo “Funções embutidas”, especialmente o parágrafo final. Atualize a redação em português de “block-reader” e considere o “para” sugerido na frase seguinte; está concluído quando a tradução renderizada corresponde à redação aceita.

Escrita pelo modelo de indexação a partir do texto da issue.

Avaliação

Stack de tecnologia
python
Domínio
documentation, localization
Tipo de issue
Documentação
Dificuldade
1/5
Tempo estimado
Menos de uma hora
Status de atividade
Estagnada
Clareza
Claramente especificada
Facilidade para iniciantes
50/100

Receba novas issues na sua caixa de entrada

Um resumo curto de issues do GitHub para quem está começando.