Submitting a pull request

The THREDDS source code is hosted on GitHub and we use its pull request feature to accept external contributions. Follow these steps to submit a pull request to Unidata:

  1. Fork the THREDDS repository.

    1. Click the "Fork" button at the upper-right corner of the THREDDS GitHub page. This will create a copy of the repository under your GitHub account.

    2. Forking a repository in GitHub.

  2. Clone your fork to your local computer.

    1. git clone https://github.com/<github_user_name>/thredds.git

  3. Change into the thredds directory.

    1. cd thredds

  4. Create a branch for the changes that you will make based on 4.6.x.

    1. git checkout -b <branch_name> 4.6.x

    2. For instance: git checkout -b fix_radar_iosp 4.6.x

  5. Make changes to the source code. See this tutorial for help building THREDDS.

  6. Commit your changes using the git add and commit commands.

  7. Push your changes to GitHub.

    1. git push -u origin <branch_name>

  8. Go to your forked THREDDS repository on GitHub (it’ll be something like https://github.com/<github_user_name>/thredds) and select the <branch_name> branch from the drop-down box at the top left.

    1. Selecting a branch on GitHub.

  9. Click the link that says "Pull Request", review the changes, and click the green "Create pull request" button.

    1. Creating a pull request on GitHub.

  10. Unidata will be notified of your request, and will be able to review the changes and discuss them with you before merging.

For more info, see GitHub’s Creating a pull request article.

Resources