Contributing to the SendGrid repositories is easy! All you need to do is find an open issue (see the bottom of this page for a list of repositories containing open issues), fix it and submit a pull request. Once you have submitted your pull request, the team can easily review it before it is merged into the repository.
To make a pull request, follow these steps:
- Log into GitHub. If you do not already have a GitHub account, you will have to create one in order to submit a change. Click the Sign up link in the upper right-hand corner to create an account. Enter your username, password, and email address. If you are an employee of SendGrid, please use your full name with your GitHub account and enter SendGrid as your company so we can easily identify you.
Once signed in, go to the repository you want to modify. There are two different options: either modifying the file directly on the GitHub website (useful when it is a single file) or forking the repository.
- Once you are viewing a file you want to modify in GitHub, click the pencil icon to begin editing:
-
Once you have made your changes, you will be given the option of creating a new branch in a Pull Request. This is a request to create a copy, or branch, of the original Docs but with your changes. Once your changes are approved, your branch will then be merged back into the original.
-
To create a Pull Request, you’ll have to fill out a Commit Changes form. Follow the built-in template and provide information about any changes you have made to the page. Leave the default branch option and name.
-
When done, click Propose file change. The team will be notified of your request, and will be able to process it.
-
Once you are viewing the repository, click the Fork button (top right corner) to create a new fork. Doing so will create a fork of the repository that you will be able to access from your profile.
-
Make changes to the fork, either by using the web interface as described above or by cloning your repository.
-
Once you have made your changes, if they have been made in your local machine, you will need to commit the changes and push them to GitHub.
-
Create a pull request.
Before creating a pull request, make sure that you respect the repository's constraints regarding contributions. You can find them in the CONTRIBUTING.md file.
- Python SDK
- PHP SDK
- C# SDK
- Ruby SDK
- Node.js SDK
- Java SDK
- Go SDK
- Python STMPAPI Client
- PHP STMPAPI Client
- C# STMPAPI Client
- Ruby STMPAPI Client
- Node.js STMPAPI Client
- Java STMPAPI Client
- Go STMPAPI Client
- Python HTTP Client
- PHP HTTP Client
- C# HTTP Client
- Java HTTP Client
- Ruby HTTP Client
- Go HTTP Client
- Node.js HTTP Client
- Open Source Data Collector
- Open API Definition
- DX Automator
- Documentation