-
Notifications
You must be signed in to change notification settings - Fork 2
/
revisando-github.qmd
51 lines (25 loc) · 4.14 KB
/
revisando-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
# Revisando via GitHub
Nesta seção, explicaremos como as revisões podem ser feitas via GitHub.
A etapa de revisão é muito mais simples do que a tradução! Portanto, caso você esteja contribuindo com o projeto pela primeira vez, recomendamos que você comece revisando um capítulo.
É importante que você leia as orientações em @sec-orientacoes, para que as traduções sigam os mesmos padrões.
Primeiramente, você precisará de uma conta no GitHub. Caso você ainda não tenha, [crie uma conta](https://github.com/signup).
## Escolhendo um capítulo para revisar
Para iniciar a revisão, você precisará escolher um capítulo para revisar. Para isso, você pode verificar a página de Pull Requests do repositório.
[{fig-alt="Captura de tela: Página de Pull Requests no repositório cienciadedatos/pt-r4ds" fig-align="center" width="95%"}](https://github.com/cienciadedatos/pt-r4ds/pulls)
No projeto de tradução do livro R4DS, a label "[Precisa: Revisor(a)](https://github.com/cienciadedatos/pt-r4ds/pulls?q=is%3Apr+is%3Aopen+label%3A%22Precisa%3A+Revisor%28a%29%22)" é utilizada para marcar os capítulos que precisam de revisor.
Abra a Pull Request do capítulo que irá revisar, e verifique se o capítulo já possui revisor. Caso não possua, você pode indicar que irá revisar o capítulo. Para isso, basta escrever um comentário na Pull Request, dizendo que irá revisar o capítulo.
{fig-alt="Captura de tela: Exemplo de Pull Request no repositório cienciadedatos/pt-r4ds" fig-align="center" width="95%"}
Clique na aba "Files changed". No botão de engrenagem, verifique se a opção escolhida para "Diff View" é "Split". Essa visualização facilitará a revisão, pois permite que as traduções sejam vistas lado a lado.
{fig-alt="Use a visualização `Files Changed -> Split` para a revisão" fig-align="center" width="95%"}
Revise a tradução. Caso encontre algo que precisa ser discutido, ou alterado, clique no botão + ao lado da linha do código alterado. Uma caixa aparecerá onde é possível deixar uma mensagem ou sugestão de alteração.
Caso queira deixar uma sugestão de alteração, clique no botão aonde mostra uma folha com o sinal de mais e menos, e será gerado um template de sugestão mais fácil de ser resolvido posteriormente:
{fig-alt="Botão para enviar sugestão de código" fig-align="center" width="10%"}
{fig-alt="Escrevendo suas sugestões referentes à algum trecho de código" fig-align="center" width="95%"}
Escreva a sugestão de alteração, e antes de enviar, clique em "Preview". Verifique se a contribuição está correta.
{fig-alt="Verifique se a sua sugestão aparece corretamente em Preview" fig-align="center" width="95%"}
Após escrever a mensagem, clique em "Start a review".
{fig-alt="Botão 'Start a Review' serve para iniciar a revisão" fig-align="center" width="95%"}
Você pode criar todas as mensagens e sugestões, e enviá-las de uma vez. Caso não consiga terminar no mesmo dia, envie suas sugestões antes de fechar a página, e avise na issue que a revisão ainda está em andamento. Assim não corre o risco de perder o que foi feito!
Para enviar as sugestões, clique em "Finish your review" (no canto superior direito), escreva uma mensagem e envie sua revisão!
{fig-alt="Botão 'Submit Review' serve para enviar a revisão" fig-align="center" width="95%"}
A pessoa responsável pela tradução do capítulo receberá um email automático do GitHub, e poderá ver e avaliar suas sugestões e comentários.