Portuguese Translation about docs.adonisjs.com HOT 26 OPEN

Teoricamente só quem entende Português entrará aqui, então vou escrever em Português mesmo.

framework

Se a wikipédia não traduz eu também não hehe. Brincadeira.
Não achei nada utilizando uma versão traduzida dessa palavra e vi vários artigos mantendo-a sem traduzir. Acho que se tivesse uma palavra melhor para usar essa pagina estável da wikipédia descreveria-a.

build

Pelo translate poderia ser compilação ou construção. Acho que pode ser construção mesmo. Não gosto de compilação pois não abrange tudo que o build faz (estou me baseando nessa resposta do stackoverflow)

release

Essa palavra é mais complicada, pois ela depende muito do contexto em que está sendo usada, e algumas vezes até some da tradução

A definição que encontrei se baseia no ISO/IEC - 20000-10 que diz:

3.2.13
release, noun
collection of one or more new or changed services (3.2.15) or service components (3.2.18) deployed into
the live environment as a result of one or more changes

Resumindo: é a disponibilização do código para o ambiente de produção. Se for um novo serviço, é o lançamento dele, então lançamento é uma tradução válida. Se for algo que já foi lançado, pode entender por liberação do código o ambiente de produção, ou uma atualização do produto.

Também encontrei o uso de palavra para se referir a uma versão do código, ou uma branch do git. Nesse contexto seria release seria a versão estável, a qual eventualmente será construída e disponibilizada para o ambiente de produção.

from docs.adonisjs.com.

For example what do you thing about using mundaça disruptiva, alteração significativa or quebra de código for breaking change

For me quebra de código make more sense.

from docs.adonisjs.com.

Minha opnião que algumas palavras não deveriam ser traduzidas. Somente traduzidas se existir uma palavra já muito bem consolidada. Quando há dúvida na tradução, eu acho melhor repensar. Acho que o caso do build é o mesmo do release. Dependendo do contexto, pode atrapalhar.

from docs.adonisjs.com.

Eu estou de acordo com @filipebraida também, sou a favor de não traduzir:

• framework
• build
• release

Como disse antes, apesar de ter traduzido release para lançamento na primeira seção, me arrependi e acho que é melhor manter Release.

Proponho de discutir esse tópico até no máximo quarta(19/05/2021). Para evitar a fadiga de discussões. Nessa data ponderamos a decisão da maioria e optamos por ela. Pode ser?

from docs.adonisjs.com.

Pode ser. Até não tenho nada contra em não traduzir palavras normalmente já usadas em inglês no nosso cotidiano.

Porém tenho 2 ressalvas:

1. Acredito que devamos traduzir ao máximo os textos para português DESDE QUE não atrapalhe o entendimento do texto.
   • ao máximo não significa tudo 😉
2. Estejamos sempre abertos para discutir/analisar caso alguém discorde das nossas traduções.
   • Isso não significa mudar o que já definimos para agradar a todos.

from docs.adonisjs.com.

Finished
introduction-installation-release
Taking
Fundamentals

from docs.adonisjs.com.

Hi Guys, I would like to contribute on this effort. How should I move forward?

from docs.adonisjs.com.

@gpbuil You can fork my repo. Pick one topic like http for example, create a branch HTTP, and start translating each subtopic: Context, Routing and so on. After you finish submit a pull request to the branch pt-translation-merging. If someone want to help you in some subtopic they should fork your repo, and submit the translation to you as a PR into your branch HTTP for example...

If you decide to pick a topic please reply to this issue

from docs.adonisjs.com.

Hi people, I'd like do discuss the merge process. I imagine that at least one person should review and aprove before merging, to help check misspelling and other errors like that.

What do you thing?

from docs.adonisjs.com.

@guntribam I rewrited your list to something more visual to help tracking the translation.
If you like pelase edit your comment with this and add the link to your Fundamentals fork

Fork stages:
💤 No fork :zzz:
✍🏼 forked :writing_hand:
👀 fork under review :eyes:
📗 translation merged :green_book:

Other ideas for:

• forked: 📖 📑 🚧 🏗️
• review: 🔍 🔎 🛂
• merged: 📚 🆗 ✔️ ✅ ☑️

from docs.adonisjs.com.

Hi Guys, I would like to contribute on this effort. How should I move forward?

You should follow gunter reply

There is also a portuguese community in adonisjs discord, in case you wanna ask for help or anything else 🙂

from docs.adonisjs.com.

@janainascal Thanks for the suggestions, I agreed with all. Some things to consider

• when posting a link to you forked repo i'll use this format for the link: @USERNAME/TOPIC it is ok?
• What do you think of the table of Translating conventions? When can use it in order to guide the review in some cases

from docs.adonisjs.com.

• when posting a link to you forked repo i'll use this format for the link: @USERNAME/TOPIC it is ok?

It's ok for me 😄

• What do you think of the table of Translating conventions? When can use it in order to guide the review in some cases

Don't know, I never translate docs before 😅
But we can discuss this here and edit the first comment to track the covention current stage

from docs.adonisjs.com.

If you google translate breaking change it suggests mudança significativa ou alteração significatica . The problem with this kind of translation it is that doesn't reflect what is actually happening. Meaningful change it is not a breaking change. I'll keep quebras de código because that shows what is actually happening.

from docs.adonisjs.com.

@janainascal What do you think of these words:

• framework
• release
• build

I don't think we should translate them (i translate release for lançamento in my first branch, but i regret it). What do you think? We should put the on the Translation Convention table?

from docs.adonisjs.com.

Minha opinião que algumas palavras não deveriam ser traduzidas.

Concordo e estamos aqui para discutí-las.

Somente traduzidas se existir uma palavra já muito bem consolidada.

Já não concordo. Acho que mais importando é o entendimento do texto do que a preocupação da tradução de palavra por palavra.

Acho que o caso do build é o mesmo do release. Dependendo do contexto, pode atrapalhar.

Você poderia dar um exemplo?

Acredito que devemos usar este issue para discutir exatamente este tipo de coisa, e se alguém mostrar erros no que usamos até o momento devemos avaliar e, dependendo, acrescentar/alterar a nossa lista de convenções

from docs.adonisjs.com.

Concordo com o @filipebraida palavras que rotineiramente são sempre usadas em inglês não deveriam ser traduzidas. Build, release, model, controller, são bons exemplos de palavras que fazem parte do dicionário diário do Dev e nunca ouvi alguém traduzindo na vida real.

from docs.adonisjs.com.

Você poderia dar um exemplo?

Vou dar um exemplo de um caso que eu vi. No livro Linguagens de Programação do Sebesta, optaram por traduzir tudo. Traduziram heap por monte. Eu já vi confundindo monte com: estrutura de dados, monte carlos, ...

Acredito que devamos traduzir ao máximo os textos para português DESDE QUE não atrapalhe o entendimento do texto.
Eu concordo, mas o ponto chave é esse limiar.

Algumas palavras não só possuem tradução específica e, sim, são quase um nome pessoal. Ela própria carrega mais do que o significado da tradução. Vejo que seria igual ao caso de traduzir um nome de uma pessoa para outra língua. Ao meu ver, ajuda os mais novos para a pesquisa. Uma pessoa entrando neste mundo, normalmente não sabe o que é framework. Imagina ela encontrando arcabouço no texto.

Proponho de discutir esse tópico até no máximo quarta(19/05/2021). Para evitar a fadiga de discussões. Nessa data ponderamos a decisão da maioria e optamos por ela. Pode ser?

Acho ótimo. Caso contrário, vai ficar eterno aqui.

Build, release, model, controller, são bons exemplos de palavras que fazem parte do dicionário diário do Dev e nunca ouvi alguém traduzindo na vida real.

Essas palavras todas tem uma tradução "oficial". Algumas palavras como classe, associação, hierarquia, e outras, não vejo problema em traduzir. Nesses dois último casos que você deu (model e controller) também não vejo muito problema traduzir.

Não necessariamente as traduções oficiais vieram de pessoas da área. Acontece muito de outras pessoas traduzirem os textos técnicos e decidirem a tradução. Fica o caso do livro do Sebesta.

Estejamos sempre abertos para discutir/analisar caso alguém discorde das nossas traduções.

Sempre!

from docs.adonisjs.com.

Essas palavras todas tem uma tradução "oficial".

Como assim "oficial"? É de uma fonte em que podemos nos basear?
Eu uso a Wikipédia em português, mas é uma fonte e não a regra

Aproveitando o gancho, quais traduções vocês acham que seriam boas para Model, View e Controller?
Na wikipédia diz que é Modelo-Visão-Controle, mas encontrei traduções de Controller para Controlador(a) e de View para Visualização.

Eu fico muito divida em traduzir ou não, pois acho controlador(a) e controle ambos ruins para nomenclatura de classe.
Por exemplo:

Já Modelo funciona bem: ModeloUsuário, UsuárioModelo, ModeloDeUsuário

from docs.adonisjs.com.

Sim, concordo. Wikipedia não é fonte e sim livros. Falei mais que já vi em livros algumas traduções, como exemplo arcabouço.

Eu fico dividido em traduzir código. Não pelo nome e sim pela rastreabilidade. Não tenho algo muito bem formado sobre isso. Tem seu lado bom e ruim.

from docs.adonisjs.com.

Voltando ao release e build, acho que como verbos deveríamos traduzir mas como substantivo não

from docs.adonisjs.com.

Até eu começar nesse meu emprego atual eu também era contra, mas como era só eu que escrevia em inglês e todo o projeto legado estava em português, escrever em inglês atrapalhava a minha comunicação com o resto do time e eu levava muito tempo para decidir a nomenclatura.

Por exemplo, uma coluna de uma tabela chama-se bom_para, é a data na qual a pessoa que gerou a nota, ou o cheque, terá dinheiro na conta para que a pessoa que recebeu possa sacar. O famoso cheque pré-datado.

Em português já é difícil de mudar, imagina em inglês.

Além disso, se formos seguir o DDD, a nomenclatura a ser implantada deve seguir o domínio, então eu não deveria renomear a coluna e deviria usar esse nome bomPara no meu modelo de domínio.

Assim sendo não estou traduzindo código para português, estou criando código em português.

from docs.adonisjs.com.

De volta ao release

Acredito que essa palavra é uma redução de release version e por isso é tão estranho para nós traduzirmos, pois traduzimos para lançamento/liberação quando deveria ser algo tipo versão lançada/liberada, ou lançamento/liberação de versão.

from docs.adonisjs.com.

Até eu começar nesse meu emprego atual eu também era contra, mas como era só eu que escrevia em inglês e todo o projeto legado estava em português, escrever em inglês atrapalhava a minha comunicação com o resto do time e eu levava muito tempo para decidir a nomenclatura.

É, nesse caso é ruim mesmo.

Acredito que essa palavra é uma redução de release version e por isso é tão estranho para nós traduzirmos, pois traduzimos para lançamento/liberação quando deveria ser algo tipo versão lançada/liberada, ou lançamento/liberação de versão.

Poderia ser lançamento de versão.

Eu fico muito divida em traduzir ou não, pois acho controlador(a) e controle ambos ruins para nomenclatura de classe.

Eu fico na dúvida por causa dos geradores de código. Ele vai manter o padrão e, talvez, fique confuso para o leitor. No texto poderia falar de controlador, modelo, ... Eu fiquei refletindo sobre o código e pensei nessa questão.

from docs.adonisjs.com.

Creio que o melhor seria traduzir no texto mas manter no código. Por exemplo, nessa seção poderia ser algo tipo:

In AdonisJS, the controllers are stored inside (but not limited to) the app/Controllers/Http directory and each file represents a single controller.

No AdonisJS, os controladores são armazenados dentro da (mas não limitado a) pasta app/Controllers/Http e cada arquivo representa um controlador

// app/Controllers/Http/PostsController.ts

export default class PostsController {
...
}

from docs.adonisjs.com.

Voltando ao release e build, acho que como verbos deveríamos traduzir mas como substantivo não

Essa abordagem, pra mim, é a mais sensata e correta!
Inclusive resolve o problema do release, build, framework, controller, model, view e de outras palavras reservadas da linguagem/tecnologia.

from docs.adonisjs.com.