Getting Started for Developers

Getting started for developers

Development of the UFS Short-Range Weather App and its subcomponents, such as the ufs-weather-model, is typically done on a user's fork. A fork is a copy of the authoritative repository and allows the user to make code changes without affecting the original repository. To set up for development work, a user will need to:

1. Create a GitHub account

2. Create fork(s) via GitHub. It is good practice to create a fork of the repository where you are doing development work, as well as any parent repository. For example, if you are modifying the ufs-weather-model repository, create a fork of the ufs-weather-model and the ufs-srweather-app repositories:

   • Login to your GitHub account
   • Go to the authoritative repository website (e.g., https://github.com/ufs-community/ufs-srweather-app or https://github.com/ufs-community/ufs-weather-model)
   • Click on "fork" in the top right corner. You will see the repository in your GitHub account.

3. Clone your fork of the ufs-srweather-app repository:

    git clone https://github.com/<your_github_username>/ufs-srweather-app.git

   Add the authoritative repository as a "remote" named upstream to keep track of changes made to this repository:

   git remote add upstream https://github.com/ufs-community/ufs-srweather-app.git

   Confirm your remotes:

   git remote -v
     origin	https://github.com/<your_github_username>/ufs-srweather-app.git (fetch)
     origin	https://github.com/<your_github_username>/ufs-srweather-app.git (push)
     upstream	https://github.com/ufs-community/ufs-srweather-app.git (fetch)
     upstream	https://github.com/ufs-community/ufs-srweather-app.git (push)

   Check that you are on the develop branch:

   git branch -a
     * develop
     remotes/origin/HEAD -> origin/develop
     remotes/origin/RRFS_baseline
     remotes/origin/develop
     remotes/origin/release/public-v1

   If you will be making changes in the ufs-srweather-app repository, make a new branch for your local development:

   git checkout -b feature/my_new_work
   git push origin feature/my_new_work

4. Run ./manage_externals/checkout_externals from the top directory to check out all of the submodules:

   Processing externals description file : Externals.cfg
   Checking status of externals: aqm-utils, ufs-weather-model, arl_nexus, ufs_utils, workflow-tools, upp, 
   Checking out externals: aqm-utils, ufs_utils, upp, arl_nexus, ufs-weather-model, workflow-tools,

You are ready to begin development by modifying or adding files.

Guidelines for code development in the ufs-srweather-app repository is here.

Information about code development in the UFS Weather Model is here.