diff --git a/cap05.Rmd b/cap05.Rmd index f335021653bc2534f083b761b5a9ace216962290..fa3475dab078fdffd003bae1b67ee449f76bc89f 100644 --- a/cap05.Rmd +++ b/cap05.Rmd @@ -271,8 +271,8 @@ colaboração, colaboradores, formas de instalação do software, caso seja um. Você pode editar o arquivo `README.md` (ou qualquer outro) no GitHub. As -moficações que fizer devem ser *commitadas* para serem salvas. O arquivo de -`README.md`, que é linguagem de marcação MarkDown, é automaticamente +moficações que fizer devem ser *commitadas* para serem salvas. O arquivo +de `README.md`, que é linguagem de marcação MarkDown, é automaticamente renderizado pelo GitHub fazendo com que urls sejam clicáveis e códigos estejam em ambientes de fonto monoespaço, além de ter títulos com tamanho de fonte apropriado e as demais renderizações. @@ -362,12 +362,37 @@ No menu da direita existem links para acessos a mais coisas: scripts direto da web. *Blame* mostra o arquivo com autor para cada porção do código. O *History* mostra o histórico de *commits*. Os dos ícones seguintes permitem editar o arquivo ou deletar. - * issues: acesso aos *issues* do projeto. Dentro dessa página tem-se - acesso às *Milestones* e requisições de merge. - * pull requests: - * wiki: - * pulse: - * graphics: + * issues: permite criação e acesso aos *issues* do projeto. Dentro + dessa página tem-se acesso às *Milestones*. + * pull requests: é o termo que o GitHub usa para requisição de + mescla. Nesta página pode submeter uma requisição e navegar nas + existentes. + * wiki: na Wiki de um repositório normalmente é feita uma documentação + mais detalhada do projeto. Páginas Wiki de um repositório são também + repositórios Git, portanto, versionáveis. + * pulse: dá um resumo sobre s quantidade issues presentes, fechados e + abertos bem como para requisções de mescla. Mostra também um resumo + da atividade recente do repositório. + * graphics: tem-se gráficos sobre a atividade no reporitório, como + frequência de *commits*, total e por autor, instantes do dia de + maior colaboração, etc. + +Existem ainda mais coisas sobre o GitHub que não podemos deixar de +comentar que são os recursos disníveis para colaboração. Nas sessões à +frente, trataremos do recurso de *fork*, *issue* e requisições de +mescla. Antes, no entanto, vamos conhecer um pouco GitLab, um serviço +web para projetos Git que pode ser instalado no seu servidor. + +O GitLab é o serviço que nós do PET usamos para colaboração em nossos +projetos. Além disso, é o que os alunos usam para fazerem seus trabalhos +e desenvolverem o TCC. O uso do Git como ferramenta de trabalho passou +ser estimulado nesse semestre (2015/2). + +Basicamente, o GitLab tem os mesmos recursos ... + +Não usamos a conta no <https://gitlab.com/>, usamos a instalação em +servidor próprio disponibilizado pelo c3sl - Centro de Computação +Científica e Software Livre - da UFPR. ## Fluxo de trabalho ##