larien/aprenda-go-com-testes

Aprenda Go com desenvolvimento orientado a testes

aprenda-go-com-testes's Issues

Implementar GitHub Actions para verificações no Pull Request

Implementar GitHub Actions para releases de merge automático

7. Pointers & Errors

Instalação do Go com Windows

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

Automatizar criação de ebooks

Trocar branch principal de master para main

11. Concurrency

3. Integers

WebSockets

Organizar pastas do repositório

Contributing

14. Sync

5. Arrays and Slices

6. Structs, Methods & Interfaces

App Intro

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

10. Mocking

Translating

Por que testes unitários?

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

Adicionar uma sessão bonus para que as pessoas possam continuar seus estudos e interagir com a comunidade

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.

Trocar nome do repositório para aprenda-go-com-testes (bagulho vai ficar louco)

12. Select

JSON, routing and embedding

Atualizar versão do Go

Capítulo (ou parte de capítulo) falando sobre gomod

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

Atualizar conteúdo em relação ao repositório original e criar issues para atualizações

2. Hello, world

HTTP server

Tradução de capítulo de "Intro to property based tests"

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.

Tradução de capítulo de "Maths"

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.

Tradução do capítulo de "Revisiting HTTP Handlers"

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.

Command line & project structure

Why

Criar glossário com termos comuns da tradução

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

4. Iteration

13. Reflection

1. Install Go

8. Maps

Instalação do Go com distribuição Linux

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

Tradução do capítulo de "Context-aware Reader"

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.

[DISCUSSÃO] Tradução dos nomes dos métodos, funções e buzzwords

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? :)

Build an application

9. Dependency Injection

Time

README.md

Go fundamentals

IO and sorting

Corrigir todas as referências para links e arquivos que possam estar incorretas

OS Exec & Error types

15. Context

Criar glossário com buzzwords utilizadas no livro e suas devidas definições

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