Download - Yes, you can git!
Y E S , Y O U C A N G I T !I N T R O D U C T I O N T O G I T A N D G I T H U B
Carol Willing@willingcarol GitHub: willingc
W R I T E S P E A K C O D E J U N E 1 7 , 2 0 1 6
– M A R Y O L I V E R
“It’s not a competition, it’s a doorway.”
C H AT T I N G W I T H F R I E N D S
• git
• a tool
• puts you in charge of source files
• GitHub
• a service
• sharing and collaboration
C A L M
N A M I N G P L A C E SL O C A L ( Y O U A R E H E R E ) , O R I G I N , U P S T R E A M
L O C A L ( Y O U A R E H E R E )
O R I G I N ( Y O U I N T H E C L O U D )
U P S T R E A M ( S O M E W H E R E E L S E I N T H E C L O U D )
L O C A L ( g i t )
O R I G I N ( y o u o n G i t H u b )
U P S T R E A M ( o p e n s o u r c e p r o j e c t o n G i t H u b )
L O C A L ( g i t )
O R I G I N ( y o u o n G i t H u b )
U P S T R E A M ( o p e n s o u r c e p r o j e c t o n G i t H u b )
remote
P E A C E F U L
G E T T I N G S TA R T E DS E T T I N G U P T O C O N T R I B U T E T O A N O P E N S O U R C E P R O J E C T
Fork an open source project
Fork
Copies source from upstream to origin
Fork an open source project
O R I G I N ( y o u o n G i t H u b )
U P S T R E A M ( o p e n s o u r c e p r o j e c t o n G i t H u b )
Click
Clone your fork of an open source project
to your local computer
git clone <url> git status git remote -v
Add a remote Let’s create a nickname of the open source project.
upstream sounds like a good nickname.
git remote -v git remote add upstream <url> git remote -v
Fork an open source project
Clone your fork
of an open source project
~/myprojects/wsc-music
https://github.com/<you>/wsc-music
https://github.com/gentlecodegarden/wsc-music
R E V I E W
C O N F I D E N T
C R E AT I N GL E T ’ S M A K E S O M E T H I N G F O R T H E P R O J E C T
fetch, rebase, push my workflow for keeping things updated
git fetch upstream git rebase upstream/master git push origin master
branch, checkout A feature branch keeps your new contribution neat and tidy.
Doing work on a feature branch helps avoid merge headaches later.
git branch new-feature git checkout new-feature
git checkout -b new-feature
git status Pro tip: use it often.
git status
git add Adds file(s) to the staging area to keep ready before committing changes.
Real world analogy: Boarding an airplane
git add <file(s)> git status
git commit Commit file(s) in the staging area to the repo history.
Real world analogy: Airplane takes off with all its passengers
git commit -m'Add commit message.' git status git log
Note: The commit exists in the local repo only at this point.
git push Shares the local commit with a remote repo.
git push origin new-feature
Note: You must have "push" privileges to push to a remote repo.
Another feature Update the local repo with upstream changes.
Create a new feature branch. Update the origin repo.
git checkout master git checkout -b another-feature git fetch upstream git rebase upstream/master git push origin another-feature
git add <files> git commit -m"Add commit message" git status git log git fetch upstream git rebase upstream/master git push origin another-feature
• Add changed files to staging area of local repo.
• Commit changed files to local branch and repo.
• Update (fetch and rebase) the local repo with any upstream changes.
• Push feature branch to the origin repo.
Another feature: add, commit, fetch, rebase, push
– A N O N Y M O U S W S C A L U M N I
“Wow! Write, Speak, Code changes lives. Remember you can go at your pace, ask questions, make mistakes, learn, and have fun too. Believe.”
C O N T R I B U T EY O U R I D E A S M A T T E R . S H A R E T H E M . S U B M I T A P U L L R E Q U E S T.
Fact: Some projects are more welcoming and encouraging than others.
Myth: Your talent, potential, and future success are defined by a maintainer’s response to your pull request.
Fact: Your PR may be rejected.
Fact: You may need to make changes based on constructive review comments.
Myth: Maintainers are entitled to belittle a pull request or be crummy to you.
Fact: It’s not you. It’s them. And their loss. Find another project that values your contribution.
L E T ’ S M A K E A P U L L R E Q U E S T
P r e s s T h e P u l l R e q u e s t B u t t o nC O N T R I B U T E A P R
W r i t e A M e s s a g e A n d S u b m i tC O N T R I B U T E A P R
T h e S u b m i t t e d P u l l R e q u e s tC O N T R I B U T E A P R
P R O U D
P a t i e n c e . M a i n t a i n e r c o m m e n t s o n P R .M A I N TA I N E R R E V I E W S T H E P R
C o n g r a t u l a t i o n s O n Yo u r C o n t r i b u t i o n !M A I N TA I N E R M E R G E S T H E P R
Y E S , Y O U C A N G I T !
Y O U D I D I T !
Thank you.
P H O T O S : C A R O L W I L L I N G , L I N N E A W I L L I N G
Y E S , Y O U C A N G I T !I N T R O D U C T I O N T O G I T A N D G I T H U B
Carol Willing@willingcarol GitHub: willingc
W R I T E S P E A K C O D E J U N E 1 7 , 2 0 1 6