|
|
| (7 intermediate revisions by 2 users not shown) |
| Line 1: |
Line 1: |
| − | == Starting a Contribution ==
| + | See https://github.com/eclipse/tycho/blob/master/CONTRIBUTING.md |
| − | | + | |
| − | Before starting to develop an enhancement or fix for Tycho, it is important that you get in touch with the project. We track ideas for enhancements and bug reports in the [https://bugs.eclipse.org/bugs/query.cgi?format=specific;product=Tycho Eclipse Bugzilla], so this is a good place to present your ideas for a patch and to make sure it's going in the right direction.
| + | |
| − | | + | |
| − | If you want to do an enhancement but don't know where to start, you can also just ask on [mailto:tycho-dev@eclipse.org tycho-dev@eclipse.org].
| + | |
| − | | + | |
| − | == Developing Patches for Tycho ==
| + | |
| − | | + | |
| − | The technical basics (how to get the sources, how to import and build, etc.) are described here: [[Developing Tycho]] .
| + | |
| − | | + | |
| − | Unless the patch is really trivial, make sure you include at least one test case that reproduces the bug or proves that the enhancement works.
| + | |
| − | | + | |
| − | Note that if '''you don't provide any tests, we will not take the contribution'''.
| + | |
| − | | + | |
| − | === Writing Tests ===
| + | |
| − | Tycho has two types of tests: unit tests (locally in each module) and a global integration test suite in module [http://git.eclipse.org/c/tycho/org.eclipse.tycho.git/tree/tycho-its tycho-its].
| + | |
| − | | + | |
| − | Unit tests are preferred if possible because they are in general much faster and better targeted at the functionality under test.
| + | |
| − | Integration tests generally invoke a forked maven build on a sample project (stored under [http://git.eclipse.org/c/tycho/org.eclipse.tycho.git/tree/tycho-its/projects projects/]) and then do some assertions on the build output.
| + | |
| − | | + | |
| − | See an example for a [http://git.eclipse.org/c/tycho/org.eclipse.tycho.git/tree/tycho-core/src/test/java/org/eclipse/tycho/core/locking/FileLockServiceTest.java unit test] and an [http://git.eclipse.org/c/tycho/org.eclipse.tycho.git/tree/tycho-its/src/test/java/org/eclipse/tycho/test/featurePatch/external/EclipseRepoIncludingFeaturePatchTest.java integration test]. | + | |
| − | | + | |
| − | === Commit Message Guidelines ===
| + | |
| − | | + | |
| − | * Start with the bug number the change is related to; don't add "bug" or puctuation marks
| + | |
| − | * Also in the first line, provide a clear and concise description of the change
| + | |
| − | * Add one blank line, followed by more details about the change. This could include a motivation for the change and/or reasons why things were done in the particular way they are done in the change.
| + | |
| − | * Add "Bug: <bug number>" in the footer.
| + | |
| − | * Add "Signed-off-by: <your_email_adress>" in the footer (see "Legal Paperwork" below).
| + | |
| − | | + | |
| − | See here for an [http://git.eclipse.org/c/tycho/org.eclipse.tycho.git/commit/?id=52ca41640484f108cae9fcaadb1c105e686dd985 example commit message]
| + | |
| − | | + | |
| − | === Commit Granularity ===
| + | |
| − | | + | |
| − | * Make small commits, yet self-contained commits. This makes them easy to review.
| + | |
| − | * Do not mix concerns in commits: have a commit do a single thing. This makes them reviewable 'in isolation'. This is particularly important if you need to do refactorings to the existing code: Refactorings tend to lead to large diffs which are difficult to review. Therefore make sure to have separate commits for refactorings and for functional changes.
| + | |
| − | | + | |
| − | == Contributing the Patch ==
| + | |
| − | | + | |
| − | === Legal Paperwork ===
| + | |
| − | | + | |
| − | Before your contribution can be accepted by the project, you need to create and
| + | |
| − | electronically sign the Eclipse Foundation Contributor License Agreement (CLA) and sign
| + | |
| − | off on the Eclipse Foundation Certificate of Origin.
| + | |
| − | | + | |
| − | Follow the instructions on [[Development_Resources/Handling Git Contributions]]
| + | |
| − | | + | |
| − | In general, also see [[Development Resources#Users: Contributing To A Project]].
| + | |
| − | | + | |
| − | === Using Gerrit ===
| + | |
| − | | + | |
| − | The [https://git.eclipse.org/r/#/q/project:tycho/org.eclipse.tycho+status:open,n,z Eclipse Gerrit] is the preferred way to propose patches to Tycho. Everyone with an Eclipse Bugzilla login can propose patches.
| + | |
| − | | + | |
| − | In order to propose a change to Tycho
| + | |
| − | * Configure the repository URL <tt>https:</tt><tt>//git.eclipse.org/r/tycho/org.eclipse.tycho.git</tt> for the remote "origin"
| + | |
| − | * Know your [https://git.eclipse.org/r/#/settings/http-password Gerrit HTTPS user name and password]
| + | |
| − | * Push to the special code review branch "refs/for/master", e.g. with <tt>git push origin HEAD:refs/for/master</tt>
| + | |
| − | | + | |
| − | For more information on the Eclipse Gerrit instance (e.g. how to push via SSH), see here: [[Gerrit]].
| + | |
| − | | + | |
| − | Note that prototypes and other incomplete work should be pushed to the refs/for/master/POC branch so committers know the nature of the changed being pushed.
| + | |
| − | | + | |
| − | === Using Bugzilla ===
| + | |
| − | | + | |
| − | Attach the patch(es) to the bug/enhancement in Bugzilla. The patch should be in the format produced by <tt>git format-patch</tt>, so that it is suitable for <tt>git am</tt>.
| + | |
| − | | + | |
| − | | + | |
| − | [[Category:Tycho|Contributor Guide]]
| + | |
| − | [[Category:How to Contribute]]
| + | |
