Jump to content
  • Sky
  • Blueberry
  • Slate
  • Blackcurrant
  • Watermelon
  • Strawberry
  • Orange
  • Banana
  • Apple
  • Emerald
  • Chocolate
  • Charcoal
FHannes

Your own OSI fork @GitHub

Recommended Posts

•((¯°·._.• ţµţ๏яɨąℓ •._.·°¯))•

 

Your own OSI fork @GitHub

 


 

1) Sign up for a GitHub account (skip this step if you have an account)

 

Go to GitHub's sign-up page, fill out the fields (Username, Email Address, Password, Confirm Password) and press the green "Create Account" button.

 

 

2) Get GitHub for Windows (skip this step if you have the application)

 

Download the GitHub for Windows application here or press the green download button in the upper-right corner of this page.

 

 

3) Fork OSI

 

Open up the OSI repository page on GitHub and press the "fork" button at the top (make sure you're logged in):

fork_osi.png

 

When a new dialog "Where do you want to fork this to?" pops up, select the desired forking location. Usually this will be your own account, rather than an organization, so press "Fork to [username]":

fork_osi.png

 

GitHub will now proceed with forking the repository, and you should land in your own OSI fork, which is your own private copy which you can modify.

 

 

4) Create a local clone

 

You'll now have to open up the GitHub Windows application. If it's your first time using it, you will have to log in with your GitHub account and set up some things, else you can just log in, if you aren't already logged in.

 

Enter your your username/email and password, after that's done, press "LOG IN":

fork_osi.png

 

Next you have to configure Git, if it isn't already filled out, fill out your name and e-mail, then press "CONTINUE":

fork_osi.png

 

At the final step, you can press "Skip":

fork_osi.png

 

Now that you've set up the application, you'll want to click your account tab in the "github" category on the left (or the organization to which you may have forked OSI), click the forked repository in the repositories list and then press "CLONE":

fork_osi.png

 

The repository will now show up as a clone in your local repositories:

fork_osi.png

 

 

5) Commit your local changes

 

Once you change something in your local clone, which will usually be located in "Documents\GitHub\OSI1", you can commit the changes locally as a sort of bundled change, called a revision.

 

In the local repositories tab of the Windows application, press the little blue arrow on the OSI1 clone item. Now you'll end up here:

fork_osi.png

 

If it isn't already showing, press the "SHOW" button on the changes. A yellow box will come up where you have to enter a description of the changes you made so far:

fork_osi.png

 

Next press "COMMIT" to commit the revision locally. It will now show up as an unsynced commit:

fork_osi.png

 

 

6) Push your local commits to your fork on GitHub

 

Once you have 1 or more unsynced commits, you can push them to your own fork on GitHub by pressing the blue "sync" button on the top of the application:

fork_osi.png

 

After syncing, the previously local commits will now show up under the history of the repository.

 

 

7) Request a pull

 

When you have made a change to OSI and you'd like it to be integrated into the actual OSI repository, you can request your changes to be pulled into the main repository. To do so, go back to the OSI fork on GitHub and press the pull request button:

fork_osi.png

 

Normally the only thing you will have to do next is press the "Send pull request" button after entering a (short) reason as to why you think the changes should be integrated into OSI:

fork_osi.png

 

Now you have to wait for the changes to be accepted or rejected.

 

 

8) Pulling updates from OSI into your own fork

 

When the main OSI repository is updated, your fork isn't. To pull the changes into your fork, open up the local repository again in the Windows application, then press tools at the top:

fork_osi.png

 

When you press "open a shell here", a powershell window will show up, with your repository as current directory:

fork_osi.png

 

To pull the changes from the main repository into your local copy, you now execute the command "git pull origin":

fork_osi.png

 


Published on the July 30th, 2012 by Frédéric Hannes

Edited by Freddy

Share this post


Link to post
Share on other sites

Join the conversation

You can post now and register later. If you have an account, sign in now to post with your account.

Guest
Reply to this topic...

×   Pasted as rich text.   Paste as plain text instead

  Only 75 emoji are allowed.

×   Your link has been automatically embedded.   Display as a link instead

×   Your previous content has been restored.   Clear editor

×   You cannot paste images directly. Upload or insert images from URL.


×
×
  • Create New...