diff --git a/cap05.Rmd b/cap05.Rmd
index beac80e72539306be39694ca20ac9361f255f789..f335021653bc2534f083b761b5a9ace216962290 100644
--- a/cap05.Rmd
+++ b/cap05.Rmd
@@ -179,10 +179,14 @@ rede social. Acesse o endereço <https://github.com/join> para preencher
seus dados pessoais e escolher um plano. Nenhum dos planos tem limitação
quanto ao número de repositórios ou colaboradores. O que muda é a
quantidade de reposiórios privados. No plano *free*, só são criados
-repositórios públicos. Dos planos pagos, o menor deles permite 5
-repositórios privados por um custo de U$ 5 por mês. Acesse
+repositórios públicos enquanto que nos planos pagos, o menor deles
+permite 5 repositórios privados por um custo de U$ 5 por mês. Acesse
<https://github.com/pricing> para mais detalhes.
+Ao preencher o formulário de criação de conta, você receberá um email
+com uma ulr de ativação. Se optar por planos pagos, terá informar número
+do cartão de crédito para que seja feito o pagamento mensalmente.
+
### Habilitar comunição ###
http://www.vogella.com/tutorials/GitHosting/article.html
@@ -195,6 +199,14 @@ máquina e o (servidor do) GitHub. A comunicação se baseia no protocolo
ssh, o qual já usamos no capítulo anterior para hospedar o repositório
em um servidor remoto.
+Para relembrar, a maioria dos servidores suporta a autenticação por SSH
+(*secure shell*). Para que seja automática, ou seja, sem precisar
+fornecer login e senha a cada acesso, usamos o recurso de pares de
+chaves. Este serve para fazer a máquina remota (servidor) reconhecer a
+máquina local (sua máquina) por da autenticação do par de chaves. É como
+se o servidor fosse um cadeado e a sua máquina local tem a chave que o
+abre.
+
Para gerar as chaves públicas, você precisa executar:
```{sh}
## Gera chaves públicas.
@@ -208,12 +220,13 @@ arquivos anteriores, terá atualizar as chaves públicas em todos os
serviços web que fazem uso desse recurso e com todos os servidores com o
qual você tem autenticação por chaves.
-No GitHub acesse <https://github.com/settings/ssh> para então adicionar
-chaves públicas (Figura XXX). Clique em `Add SSH key`, cole o conteúdo
-copiado do arquivo `*.pub` no campo `key`. No campo `Title` identifique
-a máquina correspndente àquela chave. Use, por exemplo, `laptop` ou
-`trabalho` para facilitar o reconhecimento. É comum trabalhar-se com
-mais de um máquina, como uma em casa e outra no trabalho.
+Acesse <https://github.com/settings/ssh> para então adicionar chaves
+públicas (Figura XXX) ao seu perfil. Você precisa estar logado. Clique
+em `Add SSH key`, cole o conteúdo copiado do arquivo `*.pub` no campo
+`key`. No campo `Title` identifique a máquina correspndente àquela
+chave. Use, por exemplo, `laptop` ou `trabalho` para facilitar o
+reconhecimento. É comum trabalhar-se com mais de um máquina, como uma em
+casa e outra no trabalho.
@@ -222,7 +235,7 @@ GitHub. No menu `SSH Keys` pode-se ver e adicionar chaves públicas.
Para testar a comunição entre o GitHub e a sua máquina, execute:
```{sh}
-## Testa comunição. Retorna um "Welcome" em caso positivo.
+## Testa comunição. Retorna um "Welcome!" em caso positivo.
ssh -T git@github.com
## Se falhar, habilite o modo verbose para rastrear o erro.
@@ -237,65 +250,68 @@ colaborar de forma eficiente.
No canto superior direito das páginas do GitHub existe um ícone $+$ que
permite criar um novo repositório ou uma nova organização. Clique em
-*New repository* ou acesso o endereço <https://github.com/new>. Na
+*New repository* ou acesse o endereço <https://github.com/new>. Na
janela que abrir, dê um nome para o seu projeto e adicione uma breve
descrição à ele (Figura XXX). Na etapa seguinte, defina o nível de
-visibilidade: público ou privado. Lembre-se que os planos *free* so
+visibilidade: público ou privado. Lembre-se que os planos *free* só
permitem repositórios públicos.
-FIGURA XXX: Janela para a criação de um novo repositório no GitLab.
+FIGURA XXX: Janela para a criação de um novo repositório no GitHub.
-Para criar o projeto dentro de uma Organização, no campo Owner que fica
-a esquerda do campo para o nome do repositório, selecione a Organização
-na *drop list*.
+Para criar o projeto dentro de uma Organização, selecione a Organização
+na *drop list* que fica no no campo Owner, a esquerda do campo para o
+nome do repositório.
-Ao criar o repositório você pode inicilizado criando um arquivo
-`README.md`. Como já mencionamos, esse arquivo é a capa do seu
+Você pode inicilizar o repositório com um arquivo `README.md`, o que é
+altamente recomendado. Como já mencionamos, esse arquivo é a capa do seu
repositório e serve para documentar o seu objetivo, formas de
colaboração, colaboradores, formas de instalação do software, caso seja
um.
-Você pode editar o arquivo `README.md` (ou qualquer outro) de dentro do
-GitHub. As moficações que fizer devem ser *commitadas*. O arquivo de
+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
renderizado pelo GitHub fazendo com que urls sejam clicáveis e códigos
-estejam em ambientes de fonto monoespaço.
+estejam em ambientes de fonto monoespaço, além de ter títulos com
+tamanho de fonte apropriado e as demais renderizações.
-Depois de criar o repositório, você já pode cloná-lo. O endereço do
-repositório é composto pelo seu nome de usuário e nome do repositório. O
-repositório `ola-mundo` da conta do `fulano` pode ser clonado com:
+Depois de criar o repositório, você já pode cloná-lo para trabalhar
+localmente. O endereço do repositório é composto pelo seu nome de
+usuário e nome do repositório. O repositório `ola-mundo` da conta do
+`fulano` pode ser clonado com:
```{sh}
## Clone pelo protocolo ssh. Requer chaves públicas.
git clone git@github.com:fulano/ola-mundo.git
```
-Pode-se clonar repositórios pelo protocolo `http` também. Em geral, para
-clonar repositórios de outros usuários e fazer testes, usa-se
-`http`. Prefira o *SSH* para trabalhar com os seus repositórios. O
-endereço para a ser:
+Pode-se clonar repositórios pelo protocolo `http` (*Hypertext Transfer
+Protocol*) também. Em geral, para clonar repositórios de outros usuários
+e fazer testes, usa-se `http`. Embora você possa usar `http` nos seus
+repositórios, prefira o *SSH*. Com `http`, o endereço para a ser:
```{sh}
git clone https://github.com/fulano/ola-mundo.git
```
-Por padrão, ao clonar o repositório fica dentro de uma pasta de mesmo
-nome. Em caso de preferir outro nome, por exemplo, `OlaMundo`, use:
+Por padrão, ao clonar o repositório, um diretório de mesmo nome é criado
+com o projeto em seu interior. Em caso de preferir outro nome para esse
+diretório, por exemplo, `OlaMundo`, use:
```{sh}
git clone https://github.com/fulano/ola-mundo.git OlaMundo
```
-Existe outra situação que é quando você já tem repositório Git no
-qual já está trabalhando e quer tê-lo no GitHub. Nesse caso, você faz os
+Existe outra situação que é quando você já tem repositório Git no qual
+já está trabalhando e quer tê-lo no GitHub. Nesse caso, você faz os
mesmos passos, exceto que não irá cloná-lo, apenas adicionar a url do
-repositório GitHub ao repositório local. Vamos supor que o repositório
-seja um artigo científico de nome `Artigo`. Ao criar o repositório com
-esse nome no GitHub, o endereço fica
+repositório GitHub ao repositório local e fazer um *push*. Vamos supor
+que o repositório seja um artigo científico de nome `Artigo`. Ao criar o
+repositório com esse nome no GitHub, o endereço fica
`git@github.com:fulano/Artigo.git`. Então é só adicionar esse endereço
-ao projeto Git:
+como `origin` do projeto Git:
```{sh}
## Adiciona endereço de "origin" ao repositório.
@@ -314,6 +330,45 @@ ramos, vá em *Branches*. O uso de de serviços web é configurado no
*Webhooks & services*. O *Deploy keys* permite adicionar chaves
públicas.
+
+
+Vamos considerar um repositório de bastante atividade para conhecermos
+um pouco mais dos recursos do GitHub. O repositório
+<https://github.com/yihui/knitr> é o sítio de desenvolvimento do pacote
+`knitr` do R, o principal pacote para a geração de relatórios
+dinâmicos. Nesse repositório tem-se acesso aos fontes.
+
+Na figura XXX, logo abaixo do título, tem-se quatro quantificadores:
+
+ * *commits*: ao clinar neste tem-se o histórico de *commits* com
+ autor, mensagem e sha1. É possível comparar estados dos arquivos
+ (*diff*) ao clinar no sha1.
+ * *branches*: este lista os *branches* do projeto, permite comparar
+ ramos.
+ * *releases*: documenta as modificações de uma versão para outra e
+ lista os *commits* que tem *tags*. Essa é uma fonte importate.
+ * *contributors*: dá um resumo das atividades dos colaboradores do
+ projeto. Na aba *members* tem-se uma lista de todos os usuários que
+ fizeram o *fork* do seu projeto. Falaremos de *fork* adiante.
+
+No menu da direita existem links para acessos a mais coisas:
+
+ * code: estão visíveis os diretórios e arquivos do projeto. Pode-se
+ navegar entre eles. Ao visualizar um arquivo, ele é renderizado de
+ acordo com a linguagem de código que contém para facilitar a
+ compreensão. Ao abrir um arquivo, no topo aparecer um botões de
+ exibição/ação: *Raw* é para ver o arquivo cru. A url quando estiver
+ nessa exibição pode ser usada para carregar arquivos de dados ou
+ 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:
+
## Fluxo de trabalho ##
<https://www.atlassian.com/git/>
diff --git a/images/github_repo_home.png b/images/github_repo_home.png
index 5513e1bbba669be3479065590cbaa26ef8dddef2..b9c3266897b36149a7df64fca4ab6a8c2e200f8c 100644
Binary files a/images/github_repo_home.png and b/images/github_repo_home.png differ