Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  1. Checkout OLE code from github
    1. Create a local workspace where you would want to checkout the OLE codebase
    2. clone the remote repository by issuing the following command: git clone https://github.com/openlibraryenvironment/ole.git
    3. Once its cloned, you will see a folder with the name "ole" created. 
  2. Switch to the appropriate branch
    1. Check which branch is active in your local repository by issuing the following command: git branch -a
      1. One of the listed entries should have an * next to it indicating that is the active branch currently on your local box.
    2. You will need to switch to the "develop" branch. As a best practice, we push our changes to the develop branch.
      1. Issue the following command to switch to the develop branch: git checkout develop
  3. Launch your favorite IDE and start OLE (IntelliJ IDEA instructions- coming soon!)
  4. Ongoing Development
    1. Fork your copy
      1. git clone https://github.com/user/ole.git
    2. Make changes to your local copy
      1. Switch to develop branch by using git checkout develop. This is to ensure when pull requests are created, they will be against the develop branch in the main repository. 
    3. Push changes to your forked repository
      1. You can work on changes, commit and push the changes to your own public repository. The command to use would be git commit -m "some message" followed by git push origin develop
    4. Create a pull request
      1. You can visit github.com and go to the ole repository under your username. 
      2. Click on the pull request button to initiate a pull request.
      3. Once a pull request is created, one of the core committers will review and merge the changes to the main line. 
  5. Core Committers
    1. Review pull requests
      1. Direct Diff
      2. Fetch changes locally
        1. Review
        2. Merge
        3. Push

...