larien / aprenda-go-com-testes Goto Github PK

Acredito que seria interessante para as pessoas que estão chegando na plataforma e fazendo esse tutorial, encontrar maneiras de continuar os estudos e interagir com a comunidade.

Esse capítulo foi incluído após a criação desse repositório e seu conteúdo precisa ser traduzido de acordo com a página original.
A página deve ser colocada dentro de primeiros-passos-com-go no mesmo modelo dos outros capítulos.

E aí, galera, beleza?

Boa parte de vocês veio me perguntar sobre traduzir ou não os nomes dos métodos dentro do código. Exemplo:

// Save saves an report to database.
func (r *Report) Save() error {
    // smt
    return nil
}

Eu respondi a alguns de vocês levantando os seguintes pontos:

• A ideia é diminuir a barreira de linguagem e na minha opinião, mesmo com as palavras reservadas estando em inglês, manter os nomes dos métodos em inglês iria dificultar o aprendizado
• Não é necessário traduzir as coisas de forma literal e podemos adaptar para o contexto utilizado (ex.: traduzir router para roteador, data para dados, utilizar termos comuns para a gente no geral)

Dessa forma, a tradução do exemplo acima ficaria:

// Salva armazena um relatório na base de dados.
func (r *Relatorio) Salva() error {
    // smt
    return nil
}

Ao invés de manter:

// Save armazena uma informação na base de dados.
func (r *Report) Save() error {
    // smt
    return nil
}

No entanto, gostaria de abrir essa discussão com vocês para a gente chegar em um consenso e aplicar esse estilo no decorrer do código. Quais são seus pontos em relação a não traduzir os métodos/funções/buzzwords nesse livro? Bora bater um papo? :)

Ideia incrível da @giovana-morais
Esse capítulo será uma adição ao conteúdo original do livro, em que termos em inglês serão listados, traduzidos e explicados para a pssoa que tá lendo essa belezura consultar caso encontre algum termo que não conheça pelo mundão afora e que também estão nesse livro, mas estão traduzidos.
Alguns exemplos:

storage
store
benchmark
stub
router

Edit.: Esse tópico não existe na documentação oficial. É uma adição ao conteúdo original.

Edit.: Esse tópico não existe na documentação oficial. É uma adição ao conteúdo original.

Edit.: Esse tópico não existe na documentação oficial. É uma adição ao conteúdo original.

Ideia incrível da @giovana-morais
Esse capítulo será uma adição ao conteúdo original do livro, em que termos em inglês serão listados e explicados para a pssoa que tá lendo essa belezura consultar caso encontre algum termo que não conheça pelo mundão afora e que também estão nesse livro, mas estão traduzidos.
Alguns exemplos:

• storage
• store
• benchmark
• stub
• router

Esse capítulo foi incluído após a criação desse repositório e seu conteúdo precisa ser traduzido de acordo com a página original.
A página deve ser colocada dentro de primeiros-passos-com-go no mesmo modelo dos outros capítulos.

https://larien.gitbook.io/aprenda-go-com-testes/criando-uma-aplicacao/app-intro

Esse capítulo foi incluído após a criação desse repositório e seu conteúdo precisa ser traduzido de acordo com a página original.
A página deve ser colocada dentro de duvidas-da-comunidade no mesmo modelo dos outros capítulos.

No exemplo da página https://larien.gitbook.io/aprenda-go-com-testes/meta/motivacao está assim
var cumprimentos = map[string]string { br: "Olá", fr: "Bonjour", // etc.. }

Acredito que deveria ser:
var cumprimentos = map[string]string{ "br": "Olá", "fr": "Bonjour", // etc.. }

Esse capítulo foi incluído após a criação desse repositório e seu conteúdo precisa ser traduzido de acordo com a página original.
A página deve ser colocada dentro de duvidas-da-comunidade no mesmo modelo dos outros capítulos.