Stewardship

Our stewardship of GitLab CE

Business model

GitLab Inc. is a for profit company that balances the need to improve GitLab Community Edition (CE) with the need to add features to GitLab Enterprise Edition (EE) exclusively in order to generate income. We have an open core business model and generate almost all our revenue with subscriptions to use Enterprise Edition. We recognize that we need to balance the need to generate income and with the needs of the open source project.

Promises

We promise that:

  1. We won't remove features from CE in order to make the same feature exclusive in EE (features might be removed from CE due to changes in the application)
  2. We won't introduce features into CE with a delay, if a feature is planned to land in both it will be released simultaneously in both
  3. We will always release all tests that we have for a feature that is in CE
  4. CE will have all the features that are essential to running a large 'forge' with public and private repositories
  5. CE will not contain any artificial limits (repositories, users, size, performance, etc.)
  6. All major features in our scope will be available in GitLab CE too
  7. The majority of new features made by GitLab Inc. will be available in both CE and EE
  8. CE will be available for download without leaving an email address

What features are EE only

If the wider community contributes a new feature they get to choose if it goes into CE or EE by sending the merge request to the repository they prefer (most go to CE). If the wider community contributes a feature already in EE to CE we use the process linked in Contributing an EE only feature to CE. When GitLab Inc. makes a new feature we ask ourselves, is this feature more relevant for larger organizations? If the answer is yes the feature is likely to be exclusive to EE.

There aren't any features that are only useful to larger organizations, so for every EE feature there will be smaller organizations that might need it. We're not saying that there aren't any small organizations that need the EE feature, just that we think that larger organizations are more likely to need it. The more of GitLab that you use the more likely it is that you benefit from a higher tier. Even a single person using GitLab might be best off using EE Ultimate.

It is hard to get CE vs. EE right, and if we put something in EE that should be in CE we won't hesitate to open-source it.

We always make sure that CE can do all major features in our scope and there are companies using CE with more than 10,000 users.

If people ask us why a certain feature is EE only we might reply with a link to this section of the handbook. We do not mean to imply you don't need the feature. It implies we think the feature will be more relevant for larger organizations. Feel free to make the argument for the opposite, we're listening.

What features are EE Premium

See the definition of EE Premium features in our product handbook.

Why release simultaneously in both

Sometimes people suggest having features in EE for a limited time. An example of a limited time release strategy is the Business Source License that keeps features proprietary for 3 years. At GitLab we want to give everyone access to most of the features (and all the essential ones) at the date they are announced. We want to give people the option to both run and contribute to an open source edition that is maintained and that includes the most recent security fixes. From time to time we do open source a feature that used to be EE only. We do this when we realize that we've made a mistake applying our criteria, for example when we learned that a branded homepage was an essential feature or when we brought GitLab Pages to the Community Edition.

How GitLab Inc. benefits CE

Apart from making new features GitLab Inc. does a lot of work that benefits both CE and EE:

  1. Responsible disclosure process and security fixes
  2. Release management including a monthly release of both CE and EE
  3. Packaging GitLab in our Omnibus packages
  4. Running a packages server
  5. Dependency upgrades (Rails, gems, etc.)
  6. Performance improvements

Existing contributed features in CE will never move to EE

We never move existing features already in CE, into EE. This applies regardless of whether the feature was created by GitLab Inc. or community contributors. On occasion, the reverse does happen where we bring an EE feature to CE.

Contributing an existing EE feature to CE

When someone contributes an existing EE feature to CE, we have a hard decision to make. We encourage contributors focus on new features not already existing in CE and EE, so that both CE and EE editions of GitLab benefit from the feature, and we can avoid any difficult decisions.

We encourage contributors visit our direction page to see features that are welcomed and also review CONTRIBUTING.md.

When someone contributes an existing EE feature to CE, we weigh a number of factors to decide in accepting it, including:

  1. What is the quality of the submitted code?
  2. Is it a complete replacement of the EE functionality?
  3. Does it meet the contribution acceptance criteria?
  4. Is it more relevant for mid-market organizations or larger?
  5. Is the person or organization submitting this using GitLab in an SMB?
  6. Did the person or organization submitting this contribute to GitLab before?
  7. Is it something that many of our existing customers chose GitLab Enterprise Edition for?
  8. Is it relevant for running a large open source forge?
  9. Is it an original work or based on the EE code?
  10. Is there an actively maintained fork that incorporates this?
  11. How many organizations are using this code in production?
  12. How frequently has this functionality been requested for CE and by whom?

We'll weigh all factors and you can judge our stewardship of CE based on the outcome. As of July 22, 2016, we had only two cases: One had low code quality and the other one copied the EE code down to the last space. If you find these or other examples please link them here so people can get an idea of the outcome.

In case we're not sure, we'll consult with the core team to reach a conclusion.

Contributing a not-yet-existing EE feature

When someone contributes a not yet existing feature on the EE issue tracker, and it has met the contribution acceptance criteria, we will accept it in whatever edition (CE or EE) they contribute to, provided that GitLab Inc. has not already started on working on the feature. (The contribution should not contain any already existing EE features in it.) We encourage contributors to @-mention the relevant product manager earlier in the development process (in the issue or merge request) to ensure GitLab team members are not already working on the feature in order to avoid conflicts.