|
| 1 | +.. _contrib_guide: |
| 2 | + |
| 3 | +Contributor Guide |
| 4 | +================================= |
| 5 | + |
| 6 | +.. note:: |
| 7 | + |
| 8 | + This contributor guide is written for wrf-python v1.3.x. In the |
| 9 | + not-too-distant future, wrf-python will undergo a significant refactoring |
| 10 | + to remove the wrapt decorators (which don't serialize for dask), but the |
| 11 | + concepts will remain the same as described below. |
| 12 | + |
| 13 | + |
| 14 | +Ways to Contribute |
| 15 | +----------------------------- |
| 16 | + |
| 17 | +Users are encouraged to contribute various ways. This includes: |
| 18 | + |
| 19 | +- Submitting a bug report |
| 20 | +- Submitting bug fixes |
| 21 | +- Submitting new Fortran computational routines |
| 22 | +- Submitting new Python computational routines |
| 23 | +- Submitting fully wrapped computational routines |
| 24 | + |
| 25 | + |
| 26 | +Getting the source code |
| 27 | +------------------------------ |
| 28 | + |
| 29 | +The source code is available on GitHub: |
| 30 | + |
| 31 | + https://github.com/NCAR/wrf-python |
| 32 | + |
| 33 | +To checkout the code:: |
| 34 | + |
| 35 | + git clone https://github.com/NCAR/wrf-python |
| 36 | + |
| 37 | + |
| 38 | +Git Flow |
| 39 | +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ |
| 40 | + |
| 41 | +This project follows the GitFlow Workflow, which you can read about here if it |
| 42 | +is new to you: |
| 43 | + |
| 44 | +https://leanpub.com/git-flow/read |
| 45 | + |
| 46 | +When you first clone the repository, by default you will be on the 'develop' |
| 47 | +branch, which is what you should use for your development. |
| 48 | + |
| 49 | + |
| 50 | +Pull Requests |
| 51 | +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ |
| 52 | + |
| 53 | +In order to submit changes, you must use GitHub to issue a pull request. |
| 54 | + |
| 55 | + |
| 56 | +Overview of WRF-Python Internals |
| 57 | +---------------------------------- |
| 58 | + |
| 59 | +WRF-Python is a collection of diagnostic and interpolation routines for WRF-ARW |
| 60 | +data. The API consists of a handful of functions |
| 61 | + |
| 62 | + |
| 63 | + |
0 commit comments