allymf/swift-book

Uma tradução do material em inglês do Swift para o português.

Swift Book

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

O que já pode ser traduzido

O livro em inglês está lentamente sendo migrado para o formato de Markdown antes de ser traduzido. A seguintes Sessões já estão em formato Markdown e já podem ser traduzidas através de Pull Requests:

• About Swift
• Version Compatibility
• A Swift Tour
  • Intro
  • Simple Values
  • Control Flow
  • Functions and Clojures
  • Objects and Classes
  • Enumerations and Structures
  • Protocols and Extensions
  • Error Handling
  • Generics

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 Sessao 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 marcar a Issue que está resolvendo. 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.