:orphan:

WRF Code Contribution
=====================

The WRF Model reflects a tradition of code and feature contributions from the community. An important aspect of community support for WRF is to provide up-to-date and robust software to the scientific and research community. We strive to work with code contributors and make new capabilities available to the community.

|


WRF Developers' Committee
-------------------------
The WRF Developers' Committee (DC) (described in `WRF Code Repository and Release Administration`_) is comprised of expert teams, who each preside over their corresponding part of the code (e.g. teams: software infrastructure, physics, chemistry, etc.). The DC

*   oversees management and maintenance of the WRF code repository;
*   reviews new code;
*   evaluates and processes requests to commit code to the repository.

For preparing and integrating their code, contributors may be assigned a DC liaison. 

.. note::
   Prior to making major code modifications with the intent to contribute to WRF, developers are urged to first contact the WRF Support and Development team by posting in the `WRF Support Forum`_. When necessary, a DC liaison may be assigned to assist a contributor in integrating their code. 

|

|

WRF Software Management
-----------------------
Git_ is the version control system employed by WRF, and its use, via GitHub_ is required of all contributors. WRF source code resides in the public `WRF GitHub repository`_. Requests to add code to this repository are known `pull requests`_ (PRs), and are reviewed by the relevant DC team members. See the following resources to become familiar with the Git and WRF GitHub processes. 

.. note::
   Prospective contributors must create an account on Github to be able to make and process WRF code contributions.

`Workflow for WRF Code Modification`_ |br|
`Git Basics`_ |br|
`GitHub Terminology`_ |br|
`Useful Git Commands`_ |br|
`Getting Started with Git and GitHub`_ |br|
`WRF Release Process`

|

|



.. _`WRF Code Repository and Release Administration`: http://www2.mmm.ucar.edu/wrf/users/code_contribution/code_admin.php
.. _Git: https://git-scm.com/
.. _`WRF Support Forum`: https://forum.mmm.ucar.edu/
.. _`pull requests`: https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests
.. _GitHub: https://github.com/
.. _`WRF GitHub repository`: https://github.com/wrf-model/WRF
.. _`Workflow for WRF Code Modification`: https://github.com/wrf-model/WRF/wiki/Workflow-for-WRF-Code-Modification
.. _`Git Basics`: https://try.github.io/
.. _`GitHub Terminology`: https://github.com/wrf-model/WRF/wiki/Github-terminology
.. _`Useful Git Commands`: https://github.com/wrf-model/WRF/wiki/Useful-Git-Commands
.. _`Getting Started with Git and GitHub`: https://github.com/wrf-model/WRF/wiki/PR
.. _`WRF Release Process`: https://github.com/wrf-model/WRF/wiki/WRF-Branch-Flow