Skip to main content

Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.

Jump to: navigation, search

Lyo/LyoGitHub

< Lyo

Using GitHub with Lyo

Setting up a GitHub clone

Rather than cloning the repositories directly from eclipse.org, we recommend you create an account on GitHub and fork the projects repository mirrors there. This will allow you to use GitHub's Pull Request feature to inform project committers when you have a proposed patch or contribution for consideration.

Currently active GitHub mirrors

Setting up Git for use with GitHub

See MacOS, Windows or Linux instructions for configuring your GitHub SSH keys.

Creating a repo on GitHub for use with Lyo

This example will use the Lyo RIO project as an example.

Lyo-github-fork.png

This forked repository is the only one you have write access to - the mirror repo you forked it from is read only.

Clone your GitHub repo on your development system

This example uses EGit in Eclipse

Lyo-github-clone.png

  • Complete the wizard
  • Now, add a remote for the mirror repository (the one you forked from). This allows you to track and pull incoming changes from other contrbutors
  * Expand the lyo.rio repository, right click Remotes->Create Remote
  * Give it the name upstream and select Configure fetch (you will never push to this remote, only your remote named origin)
  * Enter the URI for the original mirror you forked (as seen above).  This example will use the RIO:  https://github.com/eclipse/lyo.rio.git
  * Click Add for a RefSpec.   Pressing space in the Source field should give you the choice master [branch].  Select it and click Next and Finish.  Your fetch screen should look similar to this:

Lyo-github-remote-fetch.png

  * Click Save (or Save and Fetch)
  * To retrieve upstream changes from now on, go to the Git Repositories view.  Expand your repo -> Remotes->'upstream.   Right click the entry with the green arrow and Fetch

Lyo-github-fetch-upstream.png

  * Now merge the upstream changes into your local repo.  Right click the repository -> Merge.  Expand remotes and select upstream/master

Lyo-github-merge-upstream.png

  *  This fetch and merge process is actually much easier from the command line:
     * git fetch upstream
     * git merge upstream/master


  • At this point, continue on with the directions to build and run the RIO.

Contributing a change

  • First, make sure you have a bugzilla open for Product = Lyo at http://bugs.eclipse.org. You can make a request in the bug or on the mailing list that it be assigned to you.
  • Code your change. Make sure it is your own code. See Handling Git Contributions
  • Add the following statement to the bugzilla "I wrote all this code and have the rights to contribute it to Eclipse under the eclipse.org web site terms of use."
  • Commit your change locally and then push it to your origin remote. See instructions above for pushing. origin is your forked repository on GitHub
  * Your commit message must include the bugzilla ID and a description of the change

Back to the top