-
Notifications
You must be signed in to change notification settings - Fork 2
/
git-github.qmd
59 lines (30 loc) · 5.27 KB
/
git-github.qmd
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
# Conceitos importantes sobre Git e GitHub {#sec-git-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](https://happygitwithr.com/).
Caso tenha dificuldades em algum dos passos descritos, entre em contato com a pessoa responsável pela equipe de tradução.
## 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.
## Como instalar o Git?
Para instalar o Git, siga as instruções do [site oficial](https://git-scm.com/downloads).
## Como criar uma conta no GitHub?
Para criar uma conta no GitHub, siga as instruções do [site oficial](https://github.com/signup).
## Conceitos importantes {#sec-git-github-conceitos}
<!-- Pensar: falta algum conceito? A ordem está fazendo sentido? -->
- **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.
[{fig-alt="Captura de tela: Repositório utilizado para a tradução em Português do livro R4DS" fig-align="center" width="95%"}](https://github.com/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.
[{fig-alt="Captura de tela: Branches existentes no repositório utilizado para a tradução em Português do livro R4DS" fig-align="center" width="95%"}](https://github.com/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.
[{fig-alt="Captura de tela: Branches existentes no repositório utilizado para a tradução em Português do livro R4DS" fig-align="center" width="95%"}](https://github.com/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.
[{fig-alt="Captura de tela: Página das issues do repositório utilizado para a tradução em Português do livro R4DS" fig-align="center" width="95%"}](https://github.com/cienciadedatos/pt-r4ds/issues)
[{fig-alt="Captura de tela: Página de uma issue específica do repositório utilizado para a tradução em Português do livro R4DS" fig-align="center" width="95%"}](https://github.com/cienciadedatos/pt-r4ds/issues/36)
- **Projects**: é uma funcionalidade do GitHub para gerenciar projetos. No caso da tradução do livro R4DS, usamos para acompanhar o andamento da tradução.
[{fig-alt="Captura de tela: Página do Projects do repositório utilizado para a tradução em Português do livro R4DS" fig-align="center" width="95%"}](https://github.com/orgs/cienciadedatos/projects/2/views/1)
- **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.
[{fig-alt="Captura de tela: Fork realizado no repositório utilizado para a tradução em Português do livro R4DS" fig-align="center" width="95%"}](https://github.com/brunomioto/pt-r4ds)
- **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.
{fig-alt="Captura de tela: Pull request realizado no repositório utilizado para a tradução em Português do livro R4DS" fig-align="center" width="95%"}