Skip to content
This repository has been archived by the owner on Oct 1, 2022. It is now read-only.

Latest commit

 

History

History
37 lines (21 loc) · 2.11 KB

CONTRIBUTING.md

File metadata and controls

37 lines (21 loc) · 2.11 KB

Contribuindo com a Tradução do Swift Book

Esse projeto tem como objetivo traduzir e disponibilizar gratuitamente em português o livro The Swift Programming Language (swift 5.3).

Cada item dessa lista terá uma Issue. Antes de pegar um desses items para traduzir, verifique a Issue e descubra se alguém já não está traduzindo. Quando alguém pegar uma dessas sessao/topico para traduzir, terá o nome atribuído a Issue.

Convenções

Para facilitar o processo de revisão e diminuir as inconsistências entre traduções, quem contribuir deverá seguir algumas convenções:

  • Não traduzir palavras reservadas.
  • Na dúvida entre traduzir ou não determinado termo, deixar o termo em inglês.
  • Criar Branches no padrão sessao/topico e traduzir por Sessão e Tópico (textos mais internos dentro da Sessão).
  • Pull Requests devem ser feitos para master, marcando a Issue que resolvem.

Criação de Branches

A tradução deverá ser feita através de Forks, com branches nomeadas por sessão e tópico, com letras minúsculas, seguindo o seguinte padrão:

nome-da-sessao/nome-do-topico

Exemplo: a-swift-tour/control-flow

Caso não existam tópicos para determinada sessão, a branch deve ter somente o nome da sessão: nome-da-sessao

Pull Requests

Os Pull Requests devem ser feitos diretamente para a branch master, e utilizar o template do repositório específico para PRs. Após terminar uma tradução, lembre-se de marcá-la como traduzida no README. A revisão será feita avaliando a tradução em si, a coerência do texto da tradução, e a coerência com as traduções anteriores.

Começe Agora! 🎉

Existe pouco ou nenhum material gratuito em português de Swift / Desenvolvimento iOS básico. Contribuindo com a tradução desse livro, você pode estar ajudando alguém que não tem $$$ para comprar material a estudar. Além disso, você mesmo estará estudando, revisando, e aprendendo recursos da linguagem que você talvez não conheça.

Com esforço coletivo, conseguiremos finalizar a tradução e facilitar o aprendizado de desenvolvimento iOS para quem não sabe inglês.