Skip to content
GitLab
Explore
Sign in
Primary navigation
Search or go to…
Project
apostila-git
Manage
Activity
Members
Labels
Plan
Issues
Issue boards
Milestones
Wiki
Code
Merge requests
Repository
Branches
Commits
Tags
Repository graph
Compare revisions
Deploy
Releases
Harbor Registry
Model registry
Monitor
Incidents
Analyze
Value stream analytics
Contributor analytics
Repository analytics
Model experiments
Help
Help
Support
GitLab documentation
Compare GitLab plans
Community forum
Contribute to GitLab
Provide feedback
Keyboard shortcuts
?
Snippets
Groups
Projects
Show more breadcrumbs
pet-estatistica
apostila-git
Commits
95ee1b0c
Commit
95ee1b0c
authored
9 years ago
by
Eduardo E. R. Junior
Browse files
Options
Downloads
Patches
Plain Diff
Corrige ortografia dos documentos *.md renderizados pelo serviço web
parent
500af92c
No related branches found
No related tags found
1 merge request
!56
Issue#68
Changes
2
Hide whitespace changes
Inline
Side-by-side
Showing
2 changed files
CONTRIBUTING.md
+138
-138
138 additions, 138 deletions
CONTRIBUTING.md
plano.md
+15
-15
15 additions, 15 deletions
plano.md
with
153 additions
and
153 deletions
CONTRIBUTING.md
+
138
−
138
View file @
95ee1b0c
Guia de contribuição
====================
Esse é um projeto público do PET Estatística aberto a
colaboradores. Para que a colaboração seja bem sucedida, seguem algumas
intruções e recomendações.
## O funcionamento
O núcleo do tutorial é o arquivo
`git_tuto.Rmd`
. O arquivo
`Rmd`
é
marcado por ser escrito com sintaxe
[
markdown
][]
com fragmentos de
código R. Os fragmentos de código R são interpretados durante a
compilação feita com a função
`render`
do pacote
[
rmarkdown
][]
. Por ser
escrito em markdown, o tutorial pode ser compilado em formatos como markdown (
`.md`
), html e PDF.
Apesar de
`Rmd`
normalmente ter fragmentos de código R, nesse tutorial
predominam fragmentos de código shell, em outras palavras, são
fragmentos de código executados do terminal do Linux. Para ter um
fragmento de código shell que seja interpretado na compilação, tem-se
que fazê-lo conforme abaixo.
```
{r, engine="sh"}
comando shell
```
A compilação desse documento cria sempre um projeto Git do zero. Com
intruções do shell ao longo do documento, no instante da compilação,
arquivos são criados, adicionados (
`git add`
), commitados (
`git
commit`
), moficados, etc. Esse documento é, portanto, um documento
reproduzível.
Para compilar o documento você deve abrir uma sessão R onde o diretório
de trabalho é o que contém o arquivo
`git_tuto.Rmd`
e rodar uma chamada
da função render. Usuários do RStudio podem fazer isso diretamente pelo
botão de compilar, presente na barra de ferramentas.
```
{r, engine="sh"}
library(rmarkdown)
render("git_tuto.Rmd")
```
Os diretórios criados durante a compilação são sempre apagados, para que ao
compilar novamente, tudo seja reproduzido. O projeto deve recriar tudo e
é essa a intenção, apesar do custo. Se os diretórios não fossem
deletados antes de uma nova compilação, iria-se receber erros de
compilação.
Esse documento usa instruções no terminal que podem ser particulares do
Linux, como o comando
`tree`
e
`sed`
. Portando, a reprodutibilidade da
compilação pode não acontecer em outros sistemas operacionais.
## O fluxo de trabalho
Esse projeto terá dois ramos persistentes:
*
`devel`
: que irá receber imediatamente a contribuição dos
membros e será submetido a teste (no caso compilação). Se bem
sucedido, a contribuição é movida para o ramo
`master`
.
*
`master`
: que recebe a versão estável do projeto.
Os membros devem criar ramos de demanda para adicionarem suas
contribuições. Por exemplo, se existe a demanda (
*issue*
) de acrescentar uma
sessão sobre o uso do programa
`meld`
para resolver conflitos de merge,
deve-se criar um ramo para isso, adicionar as contribuições e subir esse
ramo para o repositório remoto. Os
*issues*
criados no GitLab são
automaticamente numerados. Para nosso benefício, vamos usar o mesmo
número ao criar os
*branches*
para atender as correspondentes
demandas. Vamos usar o padrão
`issue#?`
em que
`?`
representa o número
do
*issue*
.
```
sh
git branch
-b
issue#3
... trabalha, git add, git commit ...
... trabalha, git add, git commit ...
... trabalha, git add, git commit ...
git push origin issue#3
```
Assim que der o
`git push`
, a próxima etapa é fazer uma requisição de
*merge*
. Isso se faz pela interface do GitLab clicando em
[
merge request
][]
no menu da esquerda, dentro da página do projeto, e
depois no botão
*New Merge Request*
. Lá é onde se designa o responsável
por avaliar e aplicar o
*merge*
e quais os
*branches*
envolvidos
(doador/receptor).
Existe apenas uma regra que jamais deve ser quebrada:
> Nunca dê `push` para os ramos `devel` e `master`.
Esses ramos se receberão conteúdo provenientes de
*merge*
dos ramos de
demanda (
*issue*
).
## Mensagens de commit
É extremamente recomendado, por questões de organização e produtividade,
que as mensagens de commit sejam apropriadas. Não use mensagens vagas ou
óbvias do tipo
*Modificações feitas*
,
*Arquivos incluídos*
. Procure algo
como
*Incluí arquivo de estilo CSS*
,
*Modifica preâmbulo*
,
*
Troca
'require' por 'library'
*
(
[
5 dicas para melhores commits
][]
).
Exitem formas especiais de escrever um
*commit*
que tenha ações do
repositório remoto como fechar um
*issue*
ou fazer uma referência a
outro
*commit*
(
[
ações nas mensagens de commit
][]
). As palavras
especiais são:
`close`
,
`closes`
,
`closed`
,
`fix`
,
`fixes`
,
`fixed`
,
`resolve`
,
`resolves`
,
`resolved`
. Depois das palavras vem uma
identificação de
*issue*
ou
*sha1*
.
```
sh
git commit
-m
"Close #4. Bug devido ao encoding."
```
Visite para mais dicas de como escrever um
*commit*
:
[
como-escrever-boas-mensagens-de-commit
][]
## Escrita do código
Recomen
s
a-se fortemente que ao escrever o código, não se ultrapasse 72
caracteres por linha. Isso torna o texto/código mais legível nos
arquivos fontes. Linhas longas são difíceis de ler nos monitores atuais,
que possuem uma tela grande.
Editores de texto (de verdade) geralmente possuem formas de auto quebrar
linhas, auto indentar/acomodar ou sinalizar a margem direita. O Emacs
tem
[
auto break lines
][]
e
[
refluxo de texto
][]
. Outros editores
permitem exibir uma linha vertical para indicar o limite, como o RStudio
(> Tools > Global Options > Code > Display > Margin column).
[
markdown
]:
http://br-mac.org/2013/09/o-que-e-markdown.html
[
rmarkdown
]:
http://rmarkdown.rstudio.com/
[
merge request
]:
https://gitlab.c3sl.ufpr.br/pet-estatistica/git-tutorial/merge_requests
[
ações nas mensagens de commit
]:
https://help.github.com/articles/closing-issues-via-commit-messages/
[
5 dicas para melhores commits
]:
https://robots.thoughtbot.com/5-useful-tips-for-a-better-commit-message
[
auto break lines
]:
http://emacswiki.org/emacs/LineWrap
[
refluxo de texto
]:
http://www.emacswiki.org/emacs/FillParagraph
[
como-escrever-boas-mensagens-de-commit
]:
http://blog.diovani.com/post/101092814586/como-escrever-boas-mensagens-de-commit
Guia de contribuição
====================
Esse é um projeto público do PET Estatística aberto a
colaboradores. Para que a colaboração seja bem sucedida, seguem algumas
in
s
truções e recomendações.
## O funcionamento
O núcleo do tutorial é o arquivo
`git_tuto.Rmd`
. O arquivo
`Rmd`
é
marcado por ser escrito com sintaxe
[
markdown
][]
com fragmentos de
código R. Os fragmentos de código R são interpretados durante a
compilação feita com a função
`render`
do pacote
[
rmarkdown
][]
. Por ser
escrito em markdown, o tutorial pode ser compilado em formatos como markdown (
`.md`
), html e PDF.
Apesar de
`Rmd`
normalmente ter fragmentos de código R, nesse tutorial
predominam fragmentos de código shell, em outras palavras, são
fragmentos de código executados do terminal do Linux. Para ter um
fragmento de código shell que seja interpretado na compilação, tem-se
que fazê-lo conforme abaixo.
```{r, engine="sh"}
comando shell
```
A compilação desse documento cria sempre um projeto Git do zero. Com
in
s
truções do shell ao longo do documento, no instante da compilação,
arquivos são criados, adicionados (
`git add`
), commitados (
`git
commit`
), mo
di
ficados, etc. Esse documento é, portanto, um documento
reproduzível.
Para compilar o documento você deve abrir uma sessão R onde o diretório
de trabalho é o que contém o arquivo
`git_tuto.Rmd`
e rodar uma chamada
da função render. Usuários do RStudio podem fazer isso diretamente pelo
botão de compilar, presente na barra de ferramentas.
```{r, engine="sh"}
library(rmarkdown)
render("git_tuto.Rmd")
```
Os diretórios criados durante a compilação são sempre apagados, para que ao
compilar novamente, tudo seja reproduzido. O projeto deve recriar tudo e
é essa a intenção, apesar do custo. Se os diretórios não fossem
deletados antes de uma nova compilação, iria-se receber erros de
compilação.
Esse documento usa instruções no terminal que podem ser particulares do
Linux, como o comando
`tree`
e
`sed`
. Portando, a reprodutibilidade da
compilação pode não acontecer em outros sistemas operacionais.
## O fluxo de trabalho
Esse projeto terá dois ramos persistentes:
*
`devel`
: que irá receber imediatamente a contribuição dos
membros e será submetido a teste (no caso compilação). Se bem
sucedido, a contribuição é movida para o ramo
`master`
.
*
`master`
: que recebe a versão estável do projeto.
Os membros devem criar ramos de demanda para adicionarem suas
contribuições. Por exemplo, se existe a demanda (
*issue*
) de acrescentar uma
sessão sobre o uso do programa
`meld`
para resolver conflitos de merge,
deve-se criar um ramo para isso, adicionar as contribuições e subir esse
ramo para o repositório remoto. Os
*issues*
criados no GitLab são
automaticamente numerados. Para nosso benefício, vamos usar o mesmo
número ao criar os
*branches*
para atender as correspondentes
demandas. Vamos usar o padrão
`issue#?`
em que
`?`
representa o número
do
*issue*
.
```
sh
git branch
-b
issue#3
... trabalha, git add, git commit ...
... trabalha, git add, git commit ...
... trabalha, git add, git commit ...
git push origin issue#3
```
Assim que der o
`git push`
, a próxima etapa é fazer uma requisição de
*merge*
. Isso se faz pela interface do GitLab clicando em
[
merge request
][]
no menu da esquerda, dentro da página do projeto, e
depois no botão
*New Merge Request*
. Lá é onde se designa o responsável
por avaliar e aplicar o
*merge*
e quais os
*branches*
envolvidos
(doador/receptor).
Existe apenas uma regra que jamais deve ser quebrada:
> Nunca dê `push` para os ramos `devel` e `master`.
Esses ramos se receberão conteúdo provenientes de
*merge*
dos ramos de
demanda (
*issue*
).
## Mensagens de commit
É extremamente recomendado, por questões de organização e produtividade,
que as mensagens de commit sejam apropriadas. Não use mensagens vagas ou
óbvias do tipo
*Modificações feitas*
,
*Arquivos incluídos*
. Procure algo
como
*Incluí arquivo de estilo CSS*
,
*Modifica preâmbulo*
,
*
Troca
'require' por 'library'
*
(
[
5 dicas para melhores commits
][]
).
Exitem formas especiais de escrever um
*commit*
que tenha ações do
repositório remoto como fechar um
*issue*
ou fazer uma referência a
outro
*commit*
(
[
ações nas mensagens de commit
][]
). As palavras
especiais são:
`close`
,
`closes`
,
`closed`
,
`fix`
,
`fixes`
,
`fixed`
,
`resolve`
,
`resolves`
,
`resolved`
. Depois das palavras vem uma
identificação de
*issue*
ou
*sha1*
.
```
sh
git commit
-m
"Close #4. Bug devido ao encoding."
```
Visite para mais dicas de como escrever um
*commit*
:
[
como-escrever-boas-mensagens-de-commit
][]
## Escrita do código
Recomen
d
a-se fortemente que ao escrever o código, não se ultrapasse 72
caracteres por linha. Isso torna o texto/código mais legível nos
arquivos fontes. Linhas longas são difíceis de ler nos monitores atuais,
que possuem uma tela grande.
Editores de texto (de verdade) geralmente possuem formas de auto quebrar
linhas, auto indentar/acomodar ou sinalizar a margem direita. O Emacs
tem
[
auto break lines
][]
e
[
refluxo de texto
][]
. Outros editores
permitem exibir uma linha vertical para indicar o limite, como o RStudio
(> Tools > Global Options > Code > Display > Margin column).
[
markdown
]:
http://br-mac.org/2013/09/o-que-e-markdown.html
[
rmarkdown
]:
http://rmarkdown.rstudio.com/
[
merge request
]:
https://gitlab.c3sl.ufpr.br/pet-estatistica/git-tutorial/merge_requests
[
ações nas mensagens de commit
]:
https://help.github.com/articles/closing-issues-via-commit-messages/
[
5 dicas para melhores commits
]:
https://robots.thoughtbot.com/5-useful-tips-for-a-better-commit-message
[
auto break lines
]:
http://emacswiki.org/emacs/LineWrap
[
refluxo de texto
]:
http://www.emacswiki.org/emacs/FillParagraph
[
como-escrever-boas-mensagens-de-commit
]:
http://blog.diovani.com/post/101092814586/como-escrever-boas-mensagens-de-commit
This diff is collapsed.
Click to expand it.
plano.md
+
15
−
15
View file @
95ee1b0c
...
...
@@ -29,7 +29,7 @@
1.
Habilitar comunicação
2.
Gerenciar repositórios
3.
Fluxo de trabalho
4.
M
a
can
í
smos de colaboração
4.
M
e
can
i
smos de colaboração
1.
Issues e merge request
2.
Fork e pull request
5.
Integração contínua
...
...
@@ -54,7 +54,7 @@
1.
Clonar, modificar e subir
2.
Resolver um bug
3.
Incorporar o remoto ao local
4.
Resolver confito de merge
4.
Resolver conf
l
ito de merge
5.
Voltar o projeto para um commit
6.
Deletar ramos
7.
Criar ramo de um commit passado
...
...
@@ -84,7 +84,7 @@
+
Walmes: terminar o que tem para ser feito para GitHub, adicionar
chaves, verificar conexão, criar renomear projeto, clonar,
modificar e subir. Renomear, deletar e transferir projeto.
+
Gabriel: Descrever o us
d
o do
`init`
,
`add`
,
`commit`
, definir as
+
Gabriel: Descrever o uso do
`init`
,
`add`
,
`commit`
, definir as
três áreas de presença das modificações e acompanhar modificações
com
`diff`
,
`log`
,
`status`
e
`reflog`
.
+
Ângela: Incluir as ilustrações dos modelos de workflow.
...
...
@@ -92,13 +92,13 @@
versão preliminar da apostila correspondentes à Linux e Windows.
+
Eduardo: concluir as seções sobre uso da
`git gui`
,
`gitk`
,
`gitg`
e
`gitx`
.
+
Alessandra: configurar conexão servi
a
dor via ssh, criar e
+
Alessandra: configurar conexão servidor via ssh, criar e
transferir as chaves públicas, criar um repositório no servidor e
cloná-lo.
+
Alcides: concluir o dicionário de termos.
+
Daniel: concluir o conteúdo do
*cheat sheet*
.
3.
2015-11-10 [week03]:
+
Walmes: escrever para o GitLab o mesmo contúdo para presente para o
+
Walmes: escrever para o GitLab o mesmo cont
e
údo para presente para o
GitHub. Isso vai de uma breve descrição das funcionalidades, como
criar conta e gerenciar um repositório.
+
Gabriel:
**finalizar o trabalho da semana anterior**
. Escrever
...
...
@@ -115,17 +115,17 @@
+
Daniel: Definir o conteúdo previsto no
*cheat sheet*
e concluir o
capítulo sobre SCV. Revisar o capítulo da Ângela.
4.
2015-11-17 [week04]:
+
Walmes: descrever os mecan
í
smos de colaboração com interfaces web:
+
Walmes: descrever os mecan
i
smos de colaboração com interfaces web:
issue, fork e merge request.
+
Gabriel: Acréscimos de revisão do capítulo. Revisar os apêndices do
Alcides.
+
Ângela: Descrever o fluxo de trabalho do PET. Revisar o capítulo da
Jhenifer.
+
Jhenifer: Acrécimos de revisão. Revisão do capítulo da Alessandra.
+
Jhenifer: Acré
s
cimos de revisão. Revisão do capítulo da Alessandra.
+
Eduardo: Documentar o uso das ferramentas de merge: meld, kdiff3 e
p4merge.
+
Alessandra: Acrésci
s
mos e revisão. Revisar o capítulo da Ângela.
+
Alcides: Acrésci
s
mos e revisão. Revisar o capítulo do Gabriel.
+
Alessandra: Acréscimos e revisão. Revisar o capítulo da Ângela.
+
Alcides: Acréscimos e revisão. Revisar o capítulo do Gabriel.
+
Daniel:
**finalizar todo o trabalho da semana anterior**
. Concluir
o capítulo sobre Git com o RStudio
5.
2015-11-24 [week05]:
...
...
@@ -184,16 +184,16 @@
+
Gabriel: Disponibilizar o capítulo 3 para o Eduardo até sexta.
+
Walmes: Juntar todos os capítulos e gerar a Apostila Git.
8.
2015-12-15: Apostila Git concluída!
+
Daniel: Não concluiu nenhum dos compr
i
missos assumidos. As
pend
end
ências devem ser incorporadas na segunda fase do Projeto.
+
Daniel: Não concluiu nenhum dos compr
o
missos assumidos. As
pendências devem ser incorporadas na segunda fase do Projeto.
+
Gabriel: Enviou de forma inacabada os compromissos que assumiu;
+
Ângela: Fez a capa. Concluiu a primera fase da apostila sem nenhuma
+
Ângela: Fez a capa. Concluiu a prime
i
ra fase da apostila sem nenhuma
pendência;
+
Jhenifer: Concluiu a primera fase da apostila sem nenhuma
+
Jhenifer: Concluiu a prime
i
ra fase da apostila sem nenhuma
pendência;
+
Walmes: Concluiu a primera fase da apostila sem nenhuma pendência;
+
Walmes: Concluiu a prime
i
ra fase da apostila sem nenhuma pendência;
+
Eduardo: Concluiu com tudo em dia
+
Alessandra: Concluiu a primera fase da apostila sem nenhuma
+
Alessandra: Concluiu a prime
i
ra fase da apostila sem nenhuma
pendência;
+
Alcides: Fez as modificações mas não pediu MR.
...
...
This diff is collapsed.
Click to expand it.
Preview
0%
Loading
Try again
or
attach a new file
.
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Save comment
Cancel
Please
register
or
sign in
to comment