From 7420ce2a939e77e45a42daae421eaf5a9cbbd0ad Mon Sep 17 00:00:00 2001 From: tsutterley Date: Thu, 5 Sep 2024 13:33:05 -0700 Subject: [PATCH] docs: add model providers section to contributions --- doc/source/getting_started/Contributing.rst | 9 +++++++-- providers/README.rst | 5 ++++- 2 files changed, 11 insertions(+), 3 deletions(-) diff --git a/doc/source/getting_started/Contributing.rst b/doc/source/getting_started/Contributing.rst index b1a87df1..36399ee9 100644 --- a/doc/source/getting_started/Contributing.rst +++ b/doc/source/getting_started/Contributing.rst @@ -15,6 +15,7 @@ Ways to Contribute 3) Improving documentation and testing 4) Sharing use cases and examples (such as `Jupyter Notebooks <../user_guide/Examples.html>`_) 5) Providing code for everyone to use +6) Adding model providers to the database Requesting a Feature -------------------- @@ -61,15 +62,19 @@ Adding Examples Examples may be in the form of executable scripts or interactive `Jupyter Notebooks <../user_guide/Examples.html>`_. Fully working (but unrendered) examples should be submitted with the same steps as above. +Adding Model Providers +^^^^^^^^^^^^^^^^^^^^^^ +Model providers can be added to their respective `JSON files `_. +The main database can then be updated by running the `merge providers `_ script. + Continuous Integration ^^^^^^^^^^^^^^^^^^^^^^ We use `GitHub Actions `_ continuous integration (CI) services to build and test the project on Linux (Ubuntu) and Mac Operating Systems. -The configuration files for this service are in `.github/workflows `_. +The configuration files for this service are in the `GitHub workflows `_ directory. The workflows rely on the `environment.yml `_ and `requirements-dev.txt `_ files to install the required dependencies. The GitHub Actions jobs include: -* Updating `leap second `_ and `delta time `_ files * Running `flake8 `_ to check the code for style and compilation errors * Running the test suite on multiple combinations of OS and Python version * Uploading test coverage statistics to `Codecov `_ diff --git a/providers/README.rst b/providers/README.rst index 93c170f2..5f7ba786 100644 --- a/providers/README.rst +++ b/providers/README.rst @@ -2,7 +2,10 @@ pyTMD Providers =============== +The main database is created by merging the model provider JSON files + - ``AVISO``: `AVISO Global Ocean Tide Models `_ -- ``ESR``: `Earth and Space Research Polar Tide Models `` +- ``ESR``: `Earth and Space Research Polar Tide Models `_ - ``GSFC``: `NASA Goddard Space Flight Center Global Tide Models `_ - ``TPXO``: `Oregon State University TPXO Tide Models `_ +- ``providers``: Additional or stand-alone model providers