GitHub Book

#GitHub Book Introducing GitHub
A Non-Technical Guide
By Peter Bell, Brent Beer
Publisher: O'Reilly Media
Final Release Date: November 2014
Pages: 142

##Who This Book Is For If you are working with developers on a software project, this book is for you,whether you are a: •Business stakeholder who wants to have a sense of how your project is going
•Product or project manager who needs to ensure that software is delivered ontime and within budget
•Designer who needs to deliver anything from mockups to HTML/CSS for a project
•Copywriter who’s adding marketing copy or other content to a site or an app
•Lawyer who’s reviewing the legal implications of a project or writing the terms and conditions or privacy policy
•Team member who needs to review, comment on, and/or contribute to theproject
•Developer who is new to using GitHub and wants to learn how to collaborate using GitHub in a team

If you need to view the progress of a piece of software while it’s being developed, ifyou would like to be able to comment on the progress, and if you’d like to have theoption of contributing changes to the project, this book will show you how to effec‐tively collaborate with a software development team by using GitHub.

##Who This Book Is Not For This book is designed to teach the core skills required to collaborate effectively using GitHub. If you are already familiar with forking, cloning, and using feature branches and pull requests for collaboration, you probably won’t learn that much. Equally, if you are looking for an in-depth introduction to the Git version control system, this is not the book that you are looking for. This book covers just enough Git to do the job of introducing GitHub, but it’s not a comprehensive introduction to Git. For that you should read the excellent Version Control with Git by Jon Loeliger and Matthew McCullough (O’Reilly, 2012).

##Contents

1. Introduction................................................................ 1

   What Is Git? 1
   What Is GitHub? 1
   Why Use Git? 1
   Why Use GitHub? 2
   Key Concepts 3

2. Viewing.................................................................... 7

   Introducing the Project Page 7
   Viewing the README.md File 8
   Viewing the Commit History 9
   Viewing Pull Requests 11
   Viewing Issues 13
   Viewing the Pulse 15
   Viewing GitHub Graphs 16
   The Contributors Graph 17
   The Commits Graph 18
   The Code Frequency Graph 19
   The Punch Card Graph 20
   The Network Graph 21
   The Members List 22
   The Traffic Graph 23

3. Editing.................................................................... 25

   Contributing via a Fork 25
   Adding a File 26
   Creating a Pull Request 28
   Editing a File 36
   Renaming or Moving a File 39
   Working with Folders 41
   Creating a Folder 41
   Renaming a Folder 41
   The Limits of Editing on GitHub 42

4. Collaboration.............................................................. 43

   Committing to a Branch 43
   Creating a Pull Request from a Branch 46
   Collaborating on Pull Requests 48
   Involving People with Pull Requests 49
   Reviewing Pull Requests 49
   Commenting on Pull Requests 49
   Adding Color to Comments 50
   Contributing to Pull Requests 51
   Testing a Pull Request 53
   Merging a Pull Request 54
   Who Should Merge a Pull Request? 55
   Pull Request Notifications 55
   Best Practices for Pull Requests 56
   Issues 56
   Creating a New Issue 57
   Managing Milestones for Issues 58
   Managing Labels for Issues 60
   Commenting on Issues 61
   Referencing Issues in a Commit 61
   Best Practices for Issues 62
   Wikis 62
   Getting Started with a Wiki 62
   Adding and Linking to a Page on Your Wiki 65
   GitHub Pages 66
   Creating a Website for Your Project 66
   Creating a Website for Yourself or Your Organization 69

5. Creating and Conguring.................................................... 71

   Creating a Repository 71
   Adding Collaborators 76
   Configuring a Repository 77
   Integrating with Other Systems 79
   Personal Versus Organizational 85
   Creating an Organization 86
   Managing Teams 87

6. Downloading.............................................................. 93

   Why Clone a Repository? 93
   GitHub for Mac 94
   Making a Commit Using GitHub for Mac 103
   Viewing Changes in GitHub for Mac 106
   GitHub for Windows 109
   Making a Commit Using GitHub for Windows 116
   Configuring Command-Line Tools in GitHub for Windows 118

7. Next Steps............................................................... 121

Index....................................................................... 123