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

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):



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]":



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":



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



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



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":



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




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:



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:



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




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:



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:



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:



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:



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



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



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.

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...