Introdução ao GitHub

Peter Bell e Brent Beer

Novatec
Authorized Portuguese translation of the English edition of Introducing GitHub, ISBN 9781491949740
© 2014 Pragmatic Learning, Inc. This translation is published and sold by permission of O'Reilly
Media, Inc., which owns or controls all rights to publish and sell the same.

Tradução em português autorizada da edição em inglês da obra Introducing GitHub, ISBN 9781491949740
© 2014 Pragmatic Learning, Inc. Esta tradução é publicada e vendida com a permissão da O'Reilly
Media, Inc., detentora de todos os direitos para publicação e venda desta obra.

© Novatec Editora Ltda. [2015].

Todos os direitos reservados e protegidos pela Lei 9.610 de 19/02/1998. É proibida a reprodução desta
obra, mesmo parcial, por qualquer processo, sem prévia autorização, por escrito, do autor e da Editora.

Editor: Rubens Prates

Tradução: Lúcia A. Kinoshita
Revisão gramatical: Marta Almeida de Sá
Assistente editorial: Priscila A. Yoshimatsu
Editoração eletrônica: Carolina Kuwabata

ISBN: 978-85-7522-414-4

Histórico de impressões:
Janeiro/2015 Primeira edição

Novatec Editora Ltda.

Rua Luís Antônio dos Santos 110
02460-000 – São Paulo, SP – Brasil
Tel.: +55 11 2959-6529
Email: novatec@novatec.com.br
Site: www.novatec.com.br
Twitter: twitter.com/novateceditora
Facebook: facebook.com/novatec
LinkedIn: linkedin.com/in/novatec
 Sumário

Prefácio.............................................................................................................9

Capítulo 1 ■ Introdução.................................................................................... 13
O que é o Git?....................................................................................13
O que é o GitHub?..............................................................................13
Por que usar o Git?..............................................................................14
Por que usar o GitHub?.......................................................................15
Conceitos fundamentais......................................................................16

Capítulo 2 ■ Visualizando................................................................................. 20
Apresentando a página do projeto....................................................... 20
Visualizando o arquivo README.md................................................. 22
Visualizando o histórico de commits...................................................23
Visualizando os pull requests...............................................................24
Visualizando as issues........................................................................ 26
Visualizando o Pulse.......................................................................... 27
Visualizando os gráficos do GitHub................................................... 29
Gráfico dos colaboradores............................................................. 29
Gráficos de commits...................................................................... 31
Gráfico de frequência de código.....................................................32
Gráfico de cartão perfurado...........................................................33
Gráfico de rede............................................................................. 34
Lista de membros..........................................................................35
Gráfico de tráfego......................................................................... 36

5
6 Introdução ao GitHub

Capítulo 3 ■ Editando....................................................................................... 37
Contribuindo por meio de um fork......................................................37
Adicionando um arquivo.................................................................... 38
Criando um pull request..................................................................... 41
Editando um arquivo......................................................................... 49
Renomeando ou movendo um arquivo................................................. 51
Trabalhando com pastas......................................................................53
Criando uma pasta........................................................................53
Renomeando uma pasta................................................................ 54
Limites da edição no GitHub.............................................................. 54

Capítulo 4 ■ Colaboração.................................................................................. 56
Fazendo commits em um branch........................................................ 56
Criando um pull request a partir de um branch...................................59
Colaboração em pull requests.............................................................. 61
Envolvendo as pessoas com pull requests........................................ 61
Analisando os pull requests............................................................62
Fazendo comentários nos pull requests...........................................62
Acrescentando um pouco de diversão aos comentários................... 63
Contribuições aos pull requests..................................................... 64
Testando um pull request...............................................................67
Fazendo o merge de um pull request...............................................67
Quem deve fazer o merge de um pull request?................................ 68
Notificações de pull requests......................................................... 69
Melhores práticas para pull requests.............................................. 69
Issues................................................................................................. 71
Criando uma nova issue................................................................. 71
Administrando milestones para issues........................................... 72
Administrando rótulos para issues.................................................74
Fazendo comentários em issues......................................................75
Referenciando issues em um commit............................................. 76
Melhores práticas para issues........................................................ 76
Wikis................................................................................................ 77
Introdução a wiki......................................................................... 77
Adicionando uma página e criando um link em sua wiki............... 80
Sumário 7

Páginas GitHub.................................................................................. 81
Criando um site para o seu projeto................................................. 81
Criando um site para você mesmo ou para a sua organização......... 84

Capítulo 5 ■ Criando e configurando................................................................. 86

Criando um repositório...................................................................... 86
Adicionando colaboradores................................................................ 90
Configurando um repositório.............................................................. 91
Integração com outros sistemas.......................................................... 94
Pessoal versus organizacional.............................................................. 99
Criando uma organização.................................................................100
Administrando equipes..................................................................... 101

Capítulo 6 ■ Fazendo download...................................................................... 106

Por que clonar um repositório?..........................................................106
GitHub para Mac..............................................................................108
Fazendo um commit usando o GitHub para Mac.......................... 115
Visualizando as alterações no GitHub para Mac.............................117
GitHub para Windows......................................................................120
Fazendo um commit usando o GitHub para Windows..................126
Configurando as ferramentas de linha de comando no GitHub para
Windows................................................................................128

Capítulo 7 ■ Próximos passos.......................................................................... 130