Difference between revisions of "Development Resources/IP Due Diligence for Git and Gerrit"

From Eclipsepedia

Jump to: navigation, search
m (The Contribution)
(6 intermediate revisions by one user not shown)
Line 9: Line 9:
 
The very first paragraph contains a link to this page. Project-specific "how to contribute" pages provide a similar link.
 
The very first paragraph contains a link to this page. Project-specific "how to contribute" pages provide a similar link.
  
==The Contribution==
+
==Contribution Requirements==
  
The contribution must have the author field set to the contributor's credentials.
+
The contribution must be packaged as a Git commit record.
  
Further, the contribution my be "Signed-off-by" the contributor using identical credentials; e.g.
+
The contribution must be delivered to the Eclipse project as a pull request, or via Gerrit push.
Signed-off-by: Wayne Beaton <wayne@eclipse.org>
+
  
By signing off on a contribution, the contributor asserts that:
+
The contribution must have the author field set to the contributor's credentials (name and email address).
  
# The contribution was created in whole or in part by me and I have the right to submit it under the open source license indicated in the file; or
+
The contributor must certify the contribution. Specifically, the contributor must assert the following:
# The contribution is based upon previous work that, to the best of my knowledge, is covered under an appropriate open source license and I have the right under that license to submit that work with modifications, whether created in whole or in part by me, under the same open source license (unless I am permitted to submit under a different license), as indicated in the file; or
+
 
# The contribution was provided directly to me by some other person who certified (1), (2) or (3) and I have not modified it. I understand and agree that this project and the contribution are public and that a record of the contribution (including all personal information I submit with it, including my sign-off) is maintained indefinitely and may be redistributed consistent with this project or the open source license(s) involved."
+
<div style="padding:5px;margin:5px;border-style:solid;border-width:1px">
# I understand and agree that this project and the contribution are public and that a record of the contribution (including all personal information I submit with it, including my sign-off) is maintained indefinitely and may be redistributed consistent with this project or the open source license(s) involved."
+
# I have authored 100% of the content I'm contributing;
 +
# I have the rights to donate the content to Eclipse; and
 +
# I contribute the content under the project's license(s) (e.g. EPL)
 +
</div>
 +
 
 +
This certification must be asserted by adding a "Signed-off-by" line to the Git commit record's message using the contributor's credentials; e.g.
 +
 
 +
<pre>Make more space for the hAxis on bar charts.
 +
 
 +
The entries on the hAxis on bar charts were being truncated, making them
 +
pretty useless. By increasing the vertical space available, they render
 +
much better.
 +
 
 +
Signed-off-by: Wayne Beaton <wayne@eclipse.org></pre>
 +
 
 +
==Signing off with EGit==
 +
The EGit commit dialog has a handy button that makes adding the signed-off-by message easy.
 +
 
 +
[[Image:Signed-off-by.png]]

Revision as of 23:38, 18 November 2012

Warning2.png
This is a work-in-progress that hasn't been implemented yet. The Eclipse IP Due Diligence Process poster is the authority with regard to how IP contributions must be handled.


Git provides makes it easy to wrap and indefinitely persist contributions along with metadata. Specifically, contributions delivered via Git are packed into commit records that include the identity of the contributor, dates, comments, etc.

Project information pages include a block that looks something like this:

Contribute section.png

The very first paragraph contains a link to this page. Project-specific "how to contribute" pages provide a similar link.

Contribution Requirements

The contribution must be packaged as a Git commit record.

The contribution must be delivered to the Eclipse project as a pull request, or via Gerrit push.

The contribution must have the author field set to the contributor's credentials (name and email address).

The contributor must certify the contribution. Specifically, the contributor must assert the following:

  1. I have authored 100% of the content I'm contributing;
  2. I have the rights to donate the content to Eclipse; and
  3. I contribute the content under the project's license(s) (e.g. EPL)

This certification must be asserted by adding a "Signed-off-by" line to the Git commit record's message using the contributor's credentials; e.g.

Make more space for the hAxis on bar charts.

The entries on the hAxis on bar charts were being truncated, making them
pretty useless. By increasing the vertical space available, they render
much better.

Signed-off-by: Wayne Beaton <wayne@eclipse.org>

Signing off with EGit

The EGit commit dialog has a handy button that makes adding the signed-off-by message easy.

Signed-off-by.png