6  Conceitos importantes sobre Git e GitHub

Em alguns projetos de tradução, é utilizado o Git e o GitHub para o controle de versão dos arquivos.

Caso você não tenha familiaridade com o Git e o GitHub, recomendamos que você leia as instruções abaixo! Nesse guia, simplificamos alguns conceitos e passos, para que o foco seja deixar o seu computador pronto para contribuir com as traduções.

Caso futuramente você queira se aprofundar no Git e GitHub, recomendamos que você leia o Happy Git with R.

Caso tenha dificuldades em algum dos passos descritos, entre em contato com a pessoa responsável pela equipe de tradução.

6.1 O que é Git e GitHub?

O Git é um sistema de controle de versão distribuído, usado principalmente para o desenvolvimento de software.

O GitHub é uma plataforma de hospedagem de código com controle de versão usando o Git.

6.2 Como instalar o Git?

Para instalar o Git, siga as instruções do site oficial.

6.3 Como criar uma conta no GitHub?

Para criar uma conta no GitHub, siga as instruções do site oficial.

6.4 Conceitos importantes

• Repositório: é um diretório onde os arquivos do projeto ficam armazenados. No caso das traduções, o repositório contém os códigos do livro que está sendo traduzido.

Repositório utilizado para a tradução em Português do livro R4DS: cienciadedatos/pt-r4ds.

• Commit: é a forma de salvar uma alteração feita no código. No caso das traduções, um commit só deve conter alterações de um capítulo específico.

Exemplo de um commit realizado no repositório cienciadedatos/pt-r4ds.

• Branch: é uma ramificação do repositório. É uma forma de trabalhar em um projeto sem afetar o código que está na branch principal (geralmente é chamada de main). No caso das traduções, cada capítulo do livro é traduzido uma branch.

Branches existentes no repositório cienciadedatos/pt-r4ds.

• Issue: é uma forma de comunicação entre a comunidade, mantenedores do projeto, etc. Geralmente é usado para documentar erros, sugerir novas funcionalidades, entre outros. No caso da tradução do livro R4DS, cada capítulo do livro tem uma issue, para acompanhar o andamento da tradução.

Página com a lista de issues do repositório cienciadedatos/pt-r4ds.

Página de uma issue específica do repositório cienciadedatos/pt-r4ds.

• Projects: é uma funcionalidade do GitHub para gerenciar projetos. No caso da tradução do livro R4DS, usamos para acompanhar o andamento da tradução.

Página do projeto usado para acompanhar o andamento do projeto de tradução do livro R4DS.

• Fork: é uma cópia de um repositório para outra conta. No caso das traduções, é uma cópia do repositório livro que está sendo traduzido para a sua conta, para que você consiga realizar alterações no código e posteriormente enviar a sugestão de tradução para o repositório original.

Exemplo de um fork realizado a partir do repositório cienciadedatos/pt-r4ds para a conta de uma pessoa da equipe de tradução

• Clone: é uma cópia de um repositório para o seu computador.

• Pull request: é uma solicitação de alteração no código. No caso das traduções, é uma solicitação de alteração no capítulo que está sendo traduzido.

Exemplo de um pull request realizado no repositório cienciadedatos/pt-r4ds.