3. Checking out code and making changes

• Create an issue
• Developers shall use their own fork to checkout code and make changes. Use the 'fork' button at the top right of this page to create your own fork. Some good references for forking are:
  • Github guide to forking
  • This blog site.
  • You can also search the Github help page.
• Following the Gitflow process, all code development must be done within your fork in 'feature' branches created off 'develop'. Under Gitflow, 'develop' is the main development trunk. All code development uses this branch for syncing and coordinating.
• Please reference the issue number in all commit messages. That will attach all commit messages to their issue. Example commit message: "Update x,y and z. This commit references issue #33"
• We are a part of a big happy community of developers. So, the authoritative repository will be frequently updated with new capabilities and bug fixes. Therefore, you must keep your fork and branches up-to-date with authoritative repository.
• Keep your fork up-to-date with the authoritative repository.
  • git remote add upstream git@github.com:NOAA-EMC/UFS_UTILS.git
  • git fetch upstream
  • git checkout 'develop' (your fork)
  • git merge upstream/develop
• Once your fork is up-to-date with the authoritative repository, merge from 'develop' to your branches
  • git checkout your_branch
  • git --no-commit merge develop
  • Fix any conflicts, then commit.