In case you develop a new diagnostic with the ESMValTool, and you plan on publishing the results of the diagnostic in a peer-reviewed paper, you might want to develop the diagnostic in a slightly less open setting than the ESMValTool-public repository. That is what the ESMValTool-private repository is for. It would be great, though, if you would make the diagnostic available for the whole community after your paper was accepted. The steps that you need to take to develop a diagnostic in the private repository and then open a pull request for it in the public repository are described in the following:
For example, to clone a repository called esmvaltool-private, you would run:
git clone git@github.com:esmvalgroup/esmvaltool-private
or
git clone https://github.com/esmvalgroup/esmvaltool-private
git checkout main
git pull
git checkout -b my-awesome-diagnostic
git push -u origin my-awesome-diagnostic
the first time and
git push
any other time
Add the public repository as a remote
git remote add public git@github.com:esmvalgroup/esmvaltool
or
git remote add public https://github.com/esmvalgroup/esmvaltool
and push your branch to the public repository
git push -u public my-awesome-diagnostic
Go to https://github.com/esmalgroup/esmvaltool/pulls and click the 'New pull request button'. Process reviewer comments and get it merged as described in reviewing
.
Wait for a new release of ESMValTool. Releases are scheduled normally every four months. Find the release schedule here: release_schedule
. With the next release, your diagnostic recipe and source code will automatically be included in the archive on Zenodo and you can add the DOI from Zenodo to your paper: https://zenodo.org/record/3698045