.. _ReferenceMaterials:

********************
Reference Materials
********************

This chapter provides a collection of reference materials, including guidance documents 
(e.g., NCEP Implementation Standards), code management documents, and other useful resources.

.. _GuidanceDocs:

===================
Guidance Documents
===================

- `NCO Implementation Standards <https://www.nco.ncep.noaa.gov/idsb/implementation_standards/>`__
- `Recommendation for Adoption of NCEP EE2 Process Document <https://drive.google.com/file/d/1oLi3yH11sN2HamScB2SNrgHXmj0HYKol/view?usp=sharing>`__ *
- `Code Management of Repositories Under EMC Management Using GitFlow <https://docs.google.com/document/d/1H5McooP-ZmDIOhcy4zJwdFVk3DyjbJt_Nyqj4QGBRBU/edit?usp=sharing>`__ *
- `EMC Github Repository Code Management <https://docs.google.com/document/d/1leuJh1qVz2raTkUJz4CQf68ktqNHKEUsWrgPNtVaIH0/edit>`__ *

\* Requires NOAA email for access

.. _CodeManagement:

=========================================
Useful Code Management Related Materials
=========================================

- `UFS Github Repository Code Management <https://docs.google.com/document/d/1leuJh1qVz2raTkUJz4CQf68ktqNHKEUsWrgPNtVaIH0/edit?usp=sharing>`__ *
- `Versioning for UFS Repositories <https://docs.google.com/document/d/19yTqfTN2nu014qSUcLuNticU65q3iBern7kB-AqSoVg/edit?usp=sharing>`__ *
- `Making Code Changes in GitHub UFS Forecast Model Repository <https://docs.google.com/presentation/u/1/d/1UVq7O0djhOO99VCIbftwi-WFRdF9fjnMijZNw4kRxnM/edit>`__ *
- `ufs-weather-model Development Training Presentation <https://docs.google.com/presentation/d/1dzR6PACdFwqzJc9J-9u4RIhkxNIV3jZrRLhV53Xs8us/edit?usp=sharing>`__ *
- `GitHub at EMC Presentation <https://docs.google.com/presentation/d/16XIq0mniV1JjhrxGQ2E00mFpnzd_w9CUnpaY4_Ogi2E/edit?usp=sharing>`__ *
- More about GitFlow:

  - `A Successful Git Branching Model <https://nvie.com/posts/a-successful-git-branching-model/>`__ by Vincent Driessen
  - `GitFlow at GitHub <https://github.com/nvie/gitflow>`__
  - `GitFlow Examples <https://gitversion.net/docs/>`__ from GitVersion

\* Requires NOAA email for access

.. _UsefulResources:

=================
Useful Resources
=================

- GFS global-workflow GitHub `repository <https://github.com/NOAA-EMC/global-workflow>`__ and `wiki <https://github.com/NOAA-EMC/global-workflow/wiki>`__
- `UFS Weather Model User's Guide <https://ufs-weather-model.readthedocs.io/en/latest/>`__
- `CCPP Scientific Documentation <https://dtcenter.ucar.edu/GMTB/v6.0.0/sci_doc/index.html>`__
- UFS-UTILS `repository <https://github.com/ufs-community/UFS_UTILS>`__ and `chgres_cube documentation <https://ufs-utils.readthedocs.io/en/latest/>`__

  - `chgres_cube introduction presentation <https://drive.google.com/file/d/1JjnDlRkM5ACjJGEym14SGNFGO2wTkkB7/view?usp=sharing>`__ *

- `UFS Short-Range Weather App User's Guide <https://ufs-srweather-app.readthedocs.io/en/latest/>`__
- :term:`UPP` `repository <https://github.com/NOAA-EMC/UPP>`__ (formerly *EMC_post*)

  - `UPP Documentation <https://upp.readthedocs.io/en/latest/index.html>`__

- `FV3 multinest presentation from GFDL <https://docs.google.com/presentation/d/1cgi8J1ZzVt1EqVyRR5tzhO223p9zHBoNHJ2UPcU5Hn8/edit?usp=sharing>`__ *
- JCSDA JEDI Academy Slides: `Nov 2020 Academy Slides <http://academy.jcsda.org/nov2020/pages/slides.html>`__
- `JEDI Documentation <https://jointcenterforsatellitedataassimilation-jedi-docs.readthedocs-hosted.com/en/latest/>`__
- About Rocoto Workflow Management: `GitHub repository <https://github.com/christopherwharrop/rocoto>`__ and `documentation <http://christopherwharrop.github.io/rocoto/>`__
- `Some Git How-Tos <https://docs.google.com/document/d/1Q_WlICcDV64ejBBRxH2kI495sbZc_1hUHGPA1-AjdOI/edit?usp=sharing>`__ *
- `Configuring Git for Multiple GitHub Accounts <https://medium.freecodecamp.org/manage-multiple-github-accounts-the-ssh-way-2dadc30ccaca>`__ (this information may be useful for users with multiple GitHub accounts for configuring where Git pushes your commits)
- `EIB Seminar CMake presentation <https://drive.google.com/open?id=1PaNgPaBlDWZnwD3-JOtWArdQwffAAsFJ>`__ *

\* Requires NOAA email for access