Open Source at GitLab

1. You are here:
2. Handbook
3. Engineering
4. Open Source at GitLab

We believe in Open Source

As a company, GitLab is dedicated to open source. Not only do we believe in it, but we use it, and we give back to it. Not just through GitLab, but through contributions to other open source projects.

The purpose of this page is to document how a GitLab employee can:

• Create an open source project on behalf of GitLab
• Contribute to a third-party open source project
• Use a third-party open source code in a GitLab's project

General notes

• If you use your work email, this could help promote the company by showing that GitLab is giving back to the open source community reflecting our values of Collaboration and Transparency.

TBD

• Mention Intellectual Property https://about.gitlab.com/handbook/people-group/code-of-conduct/#intellectual-property-and-protecting-ip ?
• Mention https://about.gitlab.com/handbook/people-group/contracts-and-international-expansion/#piaa-agreements ?

Creating an open source project

See Creating a new project for the instructions.

Contributing to a third party project

Contributor License Agreements (CLAs)

TBD

• What is the process to follow to sign a CLA or corporate CLA?
• Do we track which corporate CLAs have been signed already? Would be great to have a link to the list here.

Contributing to a project on GitLab

1. Fork the repository you want to contribute to into your account
2. Follow the usual merge request flow.

In the future me might have a single place for forks. That will allow us to track various metrics about contributions made by GitLab employees.

Contributing to a project on GitHub

If your GitHub account's primary email is not your @gitlab.com email, you can add it as an additional address. No need to create a separate account.

1. Fork the repository you want to contribute to into your account
2. Follow the usual pull request flow.

In the future me might have a single organization for forks. That will allow us to track various metrics about contributions made by GitLab employees.

Using open source libraries

Acceptable Licenses

Libraries with the following licenses are acceptable for use:

• MIT License (the MIT Expat License specifically): The MIT License requires that the license itself is included with all copies of the source. It is a permissive (non-copyleft) license as defined by the Open Source Initiative.
• GNU Lesser General Public License (GNU LGPL) (version 2, version 3): GPL constraints regarding modification and redistribution under the same license are not required of projects using an LGPL library, only upon modification of the LGPL-licensed library itself.
• Apache 2.0 License: A permissive license that also provides an express grant of patent rights from contributors to users.
• Ruby 1.8 License: Dual-licensed under either itself or the GPLv2, defer to the Ruby License itself. Acceptable because of point 3b: "You may distribute the software in object code or binary form, provided that you do at least ONE of the following: b) accompany the distribution with the machine-readable source of the software."
• Ruby 1.9 License: Dual-licensed under either itself or the BSD 2-Clause License, defer to BSD 2-Clause.
• BSD 2-Clause License: A permissive (non-copyleft) license as defined by the Open Source Initiative.
• BSD 3-Clause License (also known as New BSD or Modified BSD): A permissive (non-copyleft) license as defined by the Open Source Initiative
• ISC License (also known as the OpenBSD License): A permissive (non-copyleft) license as defined by the Open Source Initiative.
• Creative Commons Zero (CC0): A public domain dedication, recommended as a way to disclaim copyright on your work to the maximum extent possible.
• Unlicense: Another public domain dedication.
• OWFa 1.0: An open-source license and patent grant designed for specifications.
• JSON License: Equivalent to the MIT license plus the statement, "The Software shall be used for Good, not Evil."

Unacceptable Licenses

Libraries with the following licenses require legal approval for use:

• GNU GPL (version 1, version 2, version 3, or any future versions): GPL-licensed libraries cannot be linked to from non-GPL projects.
• GNU AGPLv3: AGPL-licensed libraries cannot be linked to from non-GPL projects.
• Open Software License (OSL): is a copyleft license. In addition, the FSF recommend against its use.
• WTFPL: is a public domain dedication rejected by the OSI (3.2). Also has a strong language which is not in accordance with our diversity policy.

Requesting Approval for Licenses or any other Intellectual Property

Libraries that are not already approved and listed on the Acceptable Licenses list or that may be listed on the Unacceptable Licenses list may be submitted to the legal team for review and use on a case-by-case basis. Please email legal@gitlab.com with the details of how the software will be used, whether or not it will be modified, and how it will be distributed (if at all). After a decision has been made, the original requestor is responsible for updating this document, if applicable. Not all approvals will be approved for universal use and may continue to remain on the Unacceptable License list.

All inquiries relating to patents should be directed to the Legal team.

Notes

Decisions regarding the GNU GPL licenses are based on information provided by The GNU Project, as well as the Open Source Initiative, which both state that linking GPL libraries makes the program itself GPL.

If a library uses a license which is not listed above, open an issue and ask. If a license is not included in the "acceptable" list, operate under the assumption that it is not acceptable.

Keep in mind that each license has its own restrictions (typically defined in their body text). Please make sure to comply with those restrictions at all times whenever an external library is used.

Dependencies which are only used in development or test environment are exempt from license requirements, as they're not distributed for use in production.

NOTE: This document is not legal advice, nor is it comprehensive. It should not be taken as such.

Using forks in your code

Avoid using forked code and try to contribute your change upstream.

It's typical for forks to fall far behind the upstream repository and such dependencies become a source of pain:

• Rebasing the branch may become non-trivial and it'd become hard to bring such dependency up to date.
• Some other library in your project might depend on the original version, creating a diamond dependency problem.

There may be good reasons to create a fork:

• To fix a security issue that is not being fixed upstream fast enough if it's affecting us or our customers
• Any other reasons? Talk to your peers and use your best judgement.

If you decide to create a fork, make sure you open an issue that:

• Describes the reason for the fork to exist
• Links to the MR(s) where the fork was introduced as a dependency
• Links to any relevant issues in the upstream project. If the issue was not reported already, make sure you report it in the project's issue tracker. This is important because if the project's maintainers don't know about it they will not fix it
• Links to any opened MRs/PRs to fix the issue upstream
• Describes the remediation work needed to start using the upstream code again
• If it's not just changes in the forked code, but also some modifications in your code to use the fork, consider putting a TODO and a link to this issue next to that code in a comment

GPL Cooperation Commitment

Before filing or continuing to prosecute any legal proceeding or claim (other than a Defensive Action) arising from termination of a Covered License, GitLab commits to extend to the person or entity (“you”) accused of violating the Covered License the following provisions regarding cure and reinstatement, taken from GPL version 3. As used here, the term ‘this License’ refers to the specific Covered License being enforced.

However, if you cease all violation of this License, then your license from a particular copyright holder is reinstated (a) provisionally, unless and until the copyright holder explicitly and finally terminates your license, and (b) permanently, if the copyright holder fails to notify you of the violation by some reasonable means prior to 60 days after the cessation.

Moreover, your license from a particular copyright holder is reinstated permanently if the copyright holder notifies you of the violation by some reasonable means, this is the first time you have received notice of violation of this License (for any work) from that copyright holder, and you cure the violation prior to 30 days after your receipt of the notice.

GitLab intends this Commitment to be irrevocable, and binding and enforceable against GitLab and assignees of or successors to GitLab’s copyrights.

GitLab may modify this Commitment by publishing a new edition on this page or a successor location.

Definitions

‘Covered License’ means the GNU General Public License, version 2 (GPLv2), the GNU Lesser General Public License, version 2.1 (LGPLv2.1), or the GNU Library General Public License, version 2 (LGPLv2), all as published by the Free Software Foundation.

‘Defensive Action’ means a legal proceeding or claim that GitLab brings against you in response to a prior proceeding or claim initiated by you or your affiliate.

GitLab means GitLab Inc. and its affiliates and subsidiaries.