CocoaHeadsBrasil / the-swift-programming-language-in-portuguese-br

Tradução pt-BR do livro oficial do Swift

The Swift Programming Language - Tradução Português (BR)

Esse projeto é uma iniciativa do CocoaHeads Brasil que tem como objetivo traduzir o livro oficial de Swift da Apple para o Português Brasileiro.

Link do livro original: Swift.org

---

Como contribuir?

Passos para começar a ajudar:

1. Os capítulos disponíveis para tradução serão criados como issues no GitHub;
2. Os arquivos .md estão criados com o nome de cada capítulo. Ex.: bemvindo/sobre.md
3. Caso queira contribuir com a tradução, crie uma issue com o formato <seção> - <capítulo> (ex.: Bem-vindo ao Swift - Sobre o Swift), adicione a tag tradução e comente na issue avisando, para não haver traduções múltiplas do mesmo arquivo.
4. Crie uma branch para determinado arquivo que queira traduzir e faça o Pull Request.

Formatação do Markdown:

1. Palavras em inglês que não forem traduzidas, colocar em itálico;
2. Código inline colocar entre crases para ficar alo como: defina um constante de tipo String e valor "John Appleseed";
3. Código em bloco deve conter syntax highlight do Swift;
4. Traduzir termo técnico apenas se fizer sentido. Se for prejudicar o entendimento, é preferível manter o termo original. ex.: Closures. Existe uma ferramenta para tradução de terminologias da Microsoft; se fizer sentido utiliza-la para tirar dúvidas, utilize-a!
5. Notas de rodapé devem ser criadas como quote do markdown, usando o sinal de > na frente;
6. Não esqueça de habilitar o verificador ortográfico do seu editor. Isso poupa muito tempo de que está revisando. Editores preferidos: MacDown ou Mou.

Caso queira visualizar como está ficando o texto, basta utilizar o Gitbook. Para isso, siga as instruções na nossa [página do wiki] (https://github.com/CocoaHeadsBrasil/the-swift-programming-language-in-portuguese-br/wiki).

Processo de avaliação da tradução

1. Crie um Pull Request com o título no formato: <seção> - <capítulo> (ex.: Bem-vindo ao Swift - Sobre o Swift) e adicione as tags tradução && (parcial || completa)
2. Um (ou mais de um) revisor verifica o Pull Request;
3. Se achado erro de tradução ou erro de português, o revisor comenta na linha;
4. O criador do PR corrige ou responde se achar que não faz sentido, se discorda ou se tiver algo mais a acrescentar;
5. Se o criador do PR enviar alguma atualização, voltamos para o item (1);
6. Se a tradução estiver OK, o revisor comenta no final do PR com um 👍;
7. Após ao menos 2 revisões feitas, é feito o merge da tradução.

Licença

The Swift Programming Language - Tradução Português (BR) de CocoaHeads Brasil está licenciado com uma Licença Creative Commons - Atribuição-CompartilhaIgual 4.0 Internacional.
Baseado no trabalho disponível em https://github.com/CocoaHeadsBrasil/the-swift-programming-language-in-portuguese-br.