Contribute to open source using GIT

Supported by

Organized by

Question, fell free to ask at sli.do:

#KITM10

https://sli.do

How?

Fork the project
Clone the project that you fork
Update and push changes
Create a pull request
That's it

Tell me how to do that, please???

Forking the project

For learning purpose, use this sample project to contribute.

Okay then, i already open that link

Now, find that fork button

Everything goes okay

Clone the project that you fork

Use the command bellow to clone project

git clone https://github.com/wilson-ng/SimpleContribute.git

git clone [repository link]

example:

You can get repository link from click "Clone or download" labeled button

You must clone instead of Download as Zip

I will show you why you must clone it

Downloaded project

Cloned project

That's all for clone the project

Update and Push changes

First we need to create new branch for our new feature

git checkout -b [branch-name]

example

git checkout -b add-my-name

After create a new branch, we can start working

Useful tips

git checkout [branch-name]

use for switch branches or restore working tree files

git checkout -b [branch-name]

use for create a new branch with specify branch name

git checkout -t [upstream]/[branch-name]

use for create a new branch with branch name of remote tracking upstream branch name

For example, there are a task to do:

Add your name
Create Hello World! script

Update and Push changes

Add your name

update "CONTRIBUTORS.md", put your name and github link.

Create "Hello World!" script

create new file under scripts, see other scripts as a template.

Done??? Push your changes

Update and Push changes

To push your changes,

Look at what you changes with

git status

Update and Push changes

Look in detail what the hell you changes

git diff

Why new file of script doesn't show up???

git diff only tracking between commit or after indexing

Update and Push changes

Tell git to add your changes to be commit

git add .

Update and Push changes

Make sure what you changes, again...

git diff --staged

as you can see, that indexed file can be show the difference between commit

Update and Push changes

Commit your changes

git commit

example

git commit -m "add wilson"

Update and Push changes

Push your code, literally

# if you want to push new branch
git push -u origin [branch-name]

# if you want to push existing branch
git push origin [branch-name]
or
git push

DONE!!!

ALMOST DONE

Create pull request

Open your project on github

You will be notice that your recently pushed branch

Click "Compare & pull request"

Create pull request

Make sure to leave comment, so the other can know what you do

Make sure to choose base fork branch and head fork branch you want to merge to

Because you want to contribute to public project, make sure you still polite when create comment

If everything is okay and it's say able to merge,

hit "Create pull request" button

If contribution guide exists, you must read and follow it before do any changes or create a pull request

Useful tips

Find some simple project and contribute to the project, nothing to lose if you contribute to open source

Next step of this leason, you need to sync your master branch to base fork master branch, try to learn about fetch upstream and merge to your branch

That's it

Thank you

Kindly fill the feedback for the better meetup.