Releasing Code as Open Source
This is the process for releasing new open source projects/repositories to the world. In this context, releasing means publishing a repository to a site like GitHub.
The release process applies to all types of projects: personal (at home), 20%, and new Google open source releases that aren’t part of an already-established open source project (like Chromium or Android).
TIP: Changes to existing open source projects should follow go/patching. This includes releasing new versions of such projects.
TIP: Papers and publications should follow go/publications. (Any included code must still go through the process on this page.) Other academic work (like theses or advisorships) should contact emailremoved@ for guidance.
NOTE: Completing the initial steps to stage your code and send it out for review can take as little as 10 minutes for simple personal projects, or as much as an hour if there are lots of issues detected. Reviews are typically completed in a couple of days
There are several options for how to open source code at Google:
- Releasing a work or personal project
- Patching an existing project or small code exemption
- You need or want to own the copyright
This graph can help you understand the process:
This process typically takes under a week from filing to final approval, but it is best to start this process early if you have a strict deadline.
The Short Version
This is a quick overview of the releasing steps. You must still read and follow the detailed instructions at go/releasing/preparing when preparing your launch, even if you are releasing an empty project.
Read more at go/releasing/preparing
- Name your project
- Scrub the code and comments of Google proprietary information
- Include a README
- Include an Apache 2 LICENSE file and source file headers
- Include a CONTRIBUTING file
- Ensure that non-Google code is in a third_party directory
TIP: You can base your repo on https://github.com/google/new-project to save time copying boilerplate.
NOTE: If you’re in GCP start at go/oss-gcp for work related projects.
Read more at go/releasing/preparing#stage-your-code-for-review
- Push your code to an internal Git-on-Borg or Cloud Source Repository
- Set the repository ACLs to ensure that reviewers and the Cross linter can access your code
- Run the Cross linter (go/cross) to check your repository and then fix any warnings
3. Get approval
Read more at go/releasing/approval
- Create an Ariane Launch on your team or PA’s calendar (if you’re releasing a new product or website)
- Add the open source calendar. Ordering is important – must be secondary
- Ensure you set the fields as described on go/releasing/approval#settings
- Wait for approval
TIP: You can look at this sample launch to see how a launch should look.
IMPORTANT: Wait for approval before following these instructions!
- Create the external repository using go/github/repo if you’re hosting it in a Google-managed organization. Create it normally otherwise
- If your project contains encryption code, follow go/releasing-crypto
- Push your code to the external repository
- [Optional] Add your project to the Open Source Project Database
- Tell the internet about your project
- [Optional] Accept contributions from others if they sign our CLA
If any of these cases apply:
- Contributing to an existing open source project (regardless of the size or complexity of the contribution)
- Releasing snippets or gists that are fewer than 100 lines of code
- Posting code to StackOverflow
- Performing the duties of an open source project administrator
Use the very lightweight process described at go/patching. You might not have to do anything at all.
If you, or someone not at Google needs or wants to own the copyright for your code, read and follow the information at go/iarc. This is not handled by the open source team. You may decide to go down this route if this project:
- Is for your side business
- Is for someone other than you or Google
- Is one you wish to retain the copyright for
- Isn’t one you plan on open sourcing
However, it’s more than likely that going down the IARC route is overkill for you as an open source license allows the code to be used for many purposes, and you should follow the instructions in this page instead.
Q: What’s the practical difference between a work-related project and a personal project?
A: There are a few differences in the process for getting approval for a personal project.
Where you publish the code: If it’s at all related to work, it must go in an organization managed by Google (you can see all the ones we maintain at go/github/orgs). If it’s a personal project, then you can choose to release it in a Google-managed organization, or you can release it under your personal GitHub account.
go/github-docs/where has more detail about what’s a work project or and what’s personal.
NOTE: Not sure if it’s a work or personal project? Ask emailremoved@.
Approvals: Work projects may have more approvals (privacy, pcounsel, etc…).
Disclaimer: Personal projects should include the required disclaimer.
Q: Why do I have to stage my code on Git-on-Borg? Can’t I just push it to GitHub?
A: There are things that we look for in your code (like if it’s properly licensed, or if you’re vendoring third-party code correctly) during the review process before it is publicly available. Without being able to access your code, we can’t do that.
Q: I don’t really have code yet. Can I still start the launch process?
A: Yes! Start your repository using the template at https://github.com/google/new-project, or add the required files and fill out the README. Put what you have and as much detail as you can about what you’re going to implement into the launch description.
Q: Do I really have to get approval from my manager? This is just a tiny project! What gives?
A: Google does a lot of different things. It’s hard to tell what’s going to conflict with an ongoing effort without getting input from a manager. We’re trying to save you trouble later on.
Q: This process is a pain, can you automate any of it?
Yes! We’re working on it!
Q: My launch has been taking forever. What do I do?
A: If any individual item is pending for more than three work days please email emailremoved@ and let us know.
Q: I only have a Mac or Chromebook, can I release code?
A: Right now our tooling requires access to a Linux workstation or CloudTop instance. We’re working on Mac support.
Q: I want to put some code on GitHub to work with vendors, but we don’t ever plan to open source it. What should I do?
A: You should use Git-on-Borg. GitHub is only for code that is or will be open sourced.
Q: I want to update a repository that’s already gone through the launch process. Do I have to do it again?
A: No! That’s considered a patch, and you can update without a new Open Source launch entry. That said, depending on the update, you may need to go through your PA’s launch process.
Q: How do I rename a repository? Do I need to go through a new launch?
A: File a request, and we’ll probably tell you it’s ok to just do it yourself.
Q: How do I split up a repository into multiple repos?
A: File a new Ariane launch, explaining in the description that you are simply splitting up an existing repository, and link to your original Ariane launch. You can approve the Eng bit yourself, but follow the rest of the process as normal: stage your code so that we can verify the structure and licensing, specify the name of the new desired GitHub repo, etc.
For really large refactors, you can contact emailremoved@.
Q: What about projects from before I worked at Google?
A: For any project that you created on your personal GitHub account before starting at Google, you are free to do the following: 1) change the license documentation, including adding or removing any license of your choice to the repository, 2) file bugs against the project, and 3) accept external patches to the project.
To continue writing code for the project yourself, it is advised that you proceed through the go/patching process (but you must first add an open source license if it doesn’t already have one). Otherwise, you will need to obtain permission through go/iarc in order to proceed with authoring code for the project entirely independently from Google.
Q: What happens to my personal projects after I leave Google?
Email emailremoved@. We’re happy to help!
Except as otherwise noted, the content of this page is licensed under CC-BY-4.0 license. Third-party product names and logos may be the trademarks of their respective owners.