From 0a061e6c31180325309a290cd91a09bc09503806 Mon Sep 17 00:00:00 2001
From: "Michael Kavulich, Jr" <kavulich@ucar.edu>
Date: Mon, 10 Jun 2024 04:33:52 +0000
Subject: [PATCH] Added descriptions for the rest of the suites, updated a few
 others

---
 ccpp/suites/dotterel.xml   | 1 -
 ccpp/suites/dove.xml       | 1 -
 ccpp/suites/egret.xml      | 1 -
 ccpp/suites/heron.xml      | 1 -
 ccpp/suites/loon.xml       | 3 +--
 ccpp/suites/lorikeet.xml   | 1 -
 ccpp/suites/meadowlark.xml | 3 +--
 ccpp/suites/parakeet.xml   | 1 -
 ccpp/suites/pelican.xml    | 3 +--
 ccpp/suites/penguin.xml    | 4 +---
 ccpp/suites/pigeon.xml     | 1 -
 ccpp/suites/ptarmigan.xml  | 3 +--
 ccpp/suites/puffin.xml     | 3 +--
 ccpp/suites/raven.xml      | 1 -
 ccpp/suites/sandpiper.xml  | 3 +--
 ccpp/suites/shrike.xml     | 3 +--
 ccpp/suites/snowy_owl.xml  | 3 +--
 ccpp/suites/starling.xml   | 2 +-
 ccpp/suites/tern.xml       | 2 +-
 ccpp/suites/turnstone.xml  | 3 +--
 ccpp/suites/wren.xml       | 3 +--
 21 files changed, 13 insertions(+), 33 deletions(-)

diff --git a/ccpp/suites/dotterel.xml b/ccpp/suites/dotterel.xml
index 5d5d348f3..0b70ca919 100644
--- a/ccpp/suites/dotterel.xml
+++ b/ccpp/suites/dotterel.xml
@@ -3,7 +3,6 @@
 DESCRIPTION:
 Suite "dotterel" (formerly known as FV3_GFS_v17_coupled_p8_sfcocn) was used for testing an early prototype of the Global Forecast System (GFS) version 17 release. Similar to suite "pelican", except with a modified near-sea-surface temperature scheme (sfc_ocean) for use with GRIB2 input data.
 -->
-
 <suite name="dotterel" version="1">
   <!-- <init></init> -->
   <group name="time_vary">
diff --git a/ccpp/suites/dove.xml b/ccpp/suites/dove.xml
index 0513f44b1..6ccabb543 100644
--- a/ccpp/suites/dove.xml
+++ b/ccpp/suites/dove.xml
@@ -3,7 +3,6 @@
 DESCRIPTION:
 Suite "dove" (formerly known as FV3_RAP_noah) was originally developed for research and prototyping of early UFS systems. Similar to "albatross", except using the Noah Land Surface Model (instead of RUC LSM) and the GFS surface sea-ice model.
 -->
-
 <suite name="dove" version="1">
   <!-- <init></init> -->
   <group name="time_vary">
diff --git a/ccpp/suites/egret.xml b/ccpp/suites/egret.xml
index da8764e86..28afaf301 100644
--- a/ccpp/suites/egret.xml
+++ b/ccpp/suites/egret.xml
@@ -3,7 +3,6 @@
 DESCRIPTION:
 Suite "egret" (formerly known as FV3_GFS_v16_csawmg) was a suite added for experiments with the Morrison-Gettelman version 3 microphysics.
 -->
-
 <suite name="egret" version="1">
   <!-- <init></init> -->
   <group name="time_vary">
diff --git a/ccpp/suites/heron.xml b/ccpp/suites/heron.xml
index 6a1d24d93..f5ff862cc 100644
--- a/ccpp/suites/heron.xml
+++ b/ccpp/suites/heron.xml
@@ -3,7 +3,6 @@
 DESCRIPTION:
 Suite "heron" (formerly known as FV3_GFS_v16_flake) was added to test the capabilities of the Freshwater Lake (FLake) model (http://www.flake.igb-berlin.de/site/doc) for simulating freshwater lake temperatures.
 -->
-
 <suite name="heron" version="1">
   <!-- <init></init> -->
   <group name="fast_physics">
diff --git a/ccpp/suites/loon.xml b/ccpp/suites/loon.xml
index 1c7e10c4d..0fe9fdc41 100644
--- a/ccpp/suites/loon.xml
+++ b/ccpp/suites/loon.xml
@@ -1,9 +1,8 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!--
 DESCRIPTION:
-Suite "loon" (formerly known as FV3_GFS_v16_fv3wam)
+Suite "loon" (formerly known as FV3_GFS_v16_fv3wam) was originally developed for early prototypes of the FV3-based Whole Atmosphere Model (WAM).
 -->
-
 <suite name="loon" version="1">
   <!-- <init></init> -->
   <group name="time_vary">
diff --git a/ccpp/suites/lorikeet.xml b/ccpp/suites/lorikeet.xml
index af350ba18..72600364a 100644
--- a/ccpp/suites/lorikeet.xml
+++ b/ccpp/suites/lorikeet.xml
@@ -3,7 +3,6 @@
 DESCRIPTION:
 Suite "lorikeet" (formerly known as FV3_HAFS_v1_thompson) is similar (though not identical) to the physics suite used by the operational HAFS-B configuration. When using GRIB2 input data, or coupled with an ocean model, use suite "hornbill" instead.
 -->
-
 <suite name="lorikeet" version="1">
   <!-- <init></init> -->
   <group name="time_vary">
diff --git a/ccpp/suites/meadowlark.xml b/ccpp/suites/meadowlark.xml
index 33876e027..6da5f7a6c 100644
--- a/ccpp/suites/meadowlark.xml
+++ b/ccpp/suites/meadowlark.xml
@@ -1,9 +1,8 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!--
 DESCRIPTION:
-Suite "meadowlark" (formerly known as FV3_RAP_noah_sfcdiff_cires_ugwp)
+Suite "meadowlark" (formerly known as FV3_RAP_noah_sfcdiff_cires_ugwp) was originally developed for research and prototyping of early UFS systems. Designed to emulate the RAP physics, but with several differences, including the surface scheme, land surface model, and gravity wave parameterizations.
 -->
-
 <suite name="meadowlark" version="1">
   <!-- <init></init> -->
   <group name="time_vary">
diff --git a/ccpp/suites/parakeet.xml b/ccpp/suites/parakeet.xml
index 99ba3cca0..6e1589011 100644
--- a/ccpp/suites/parakeet.xml
+++ b/ccpp/suites/parakeet.xml
@@ -3,7 +3,6 @@
 DESCRIPTION:
 Suite "parakeet" (formerly known as FV3_GFS_v17_p8_c3) was used for testing an early prototype of the Global Forecast System (GFS) version 17 release. While it is similar to the physics used for this prototype (P8), it is not identical, and the eventual operational implementation of GFS version 17 will likely be quite different.
 -->
-
 <suite name="parakeet" version="1">
   <!-- <init></init> -->
   <group name="time_vary">
diff --git a/ccpp/suites/pelican.xml b/ccpp/suites/pelican.xml
index 5f0145f91..71d255981 100644
--- a/ccpp/suites/pelican.xml
+++ b/ccpp/suites/pelican.xml
@@ -1,9 +1,8 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!--
 DESCRIPTION:
-Suite "pelican" (formerly known as FV3_GFS_v17_coupled_p8)
+Suite "pelican" (formerly known as FV3_GFS_v17_coupled_p8) was used for testing an early prototype of the Global Forecast System (GFS) version 17 release. While it is similar to the physics used for this prototype (P8), it is not identical, and the eventual operational implementation of GFS version 17 will likely be quite different. Identical to suite "bluebird", except with the "sfc_cice" physics routine used for coupling with the Community Ice Code (CICE) sea-ice model (https://www.cesm.ucar.edu/models/cice).
 -->
-
 <suite name="pelican" version="1">
   <!-- <init></init> -->
   <group name="time_vary">
diff --git a/ccpp/suites/penguin.xml b/ccpp/suites/penguin.xml
index b5e16216d..a4e9641f9 100644
--- a/ccpp/suites/penguin.xml
+++ b/ccpp/suites/penguin.xml
@@ -1,10 +1,8 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!--
 DESCRIPTION:
-Suite "penguin" (formerly known as RRFSens_phy5) is one of the suites used in early prototypes of the Rapid Refresh Forecast System (R
-RFS) multi-physics ensemble.
+Suite "penguin" (formerly known as RRFSens_phy5) is one of the suites used in early prototypes of the Rapid Refresh Forecast System (RRFS) multi-physics ensemble.
 -->
-
 <suite name="penguin" version="1">
   <!-- <init></init> -->
   <group name="time_vary">
diff --git a/ccpp/suites/pigeon.xml b/ccpp/suites/pigeon.xml
index a86794690..a8624b100 100644
--- a/ccpp/suites/pigeon.xml
+++ b/ccpp/suites/pigeon.xml
@@ -3,7 +3,6 @@
 DESCRIPTION:
 Suite "pigeon" (formerly known as FV3_RRFS_v1beta) was originally developed for an early prototype of the Rapid Refresh Forecast System (RRFS).
 -->
-
 <suite name="pigeon" version="1">
   <!-- <init></init> -->
   <group name="time_vary">
diff --git a/ccpp/suites/ptarmigan.xml b/ccpp/suites/ptarmigan.xml
index 19efbc242..cfda0c74f 100644
--- a/ccpp/suites/ptarmigan.xml
+++ b/ccpp/suites/ptarmigan.xml
@@ -1,8 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!--
 DESCRIPTION:
-Suite "ptarmigan" (formerly known as RRFSens_phy2) is one of the suites used in early prototypes of the Rapid Refresh Forecast System (R
-RFS) multi-physics ensemble.
+Suite "ptarmigan" (formerly known as RRFSens_phy2) is one of the suites used in early prototypes of the Rapid Refresh Forecast System (RRFS) multi-physics ensemble.
 -->
 <suite name="ptarmigan" version="1">
   <!-- <init></init> -->
diff --git a/ccpp/suites/puffin.xml b/ccpp/suites/puffin.xml
index a6c188ffb..ec236e5f7 100644
--- a/ccpp/suites/puffin.xml
+++ b/ccpp/suites/puffin.xml
@@ -1,8 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!--
 DESCRIPTION:
-Suite "puffin" (formerly known as RRFSens_phy1) is one of the suites used in early prototypes of the Rapid Refresh Forecast System (R
-RFS) multi-physics ensemble.
+Suite "puffin" (formerly known as RRFSens_phy1) is one of the suites used in early prototypes of the Rapid Refresh Forecast System (RRFS) multi-physics ensemble.
 -->
 <suite name="puffin" version="1">
   <!-- <init></init> -->
diff --git a/ccpp/suites/raven.xml b/ccpp/suites/raven.xml
index 83f509390..495a8f361 100644
--- a/ccpp/suites/raven.xml
+++ b/ccpp/suites/raven.xml
@@ -3,7 +3,6 @@
 DESCRIPTION:
 Suite "raven" (formerly known as FV3_GFS_v16) was originally developed for research and prototyping of early UFS systems. It was meant to emulate the operational GFS v16 suite, though it had some differences from the operational implementation (which was not CCPP-based).
 -->
-
 <suite name="raven" version="1">
   <!-- <init></init> -->
   <group name="fast_physics">
diff --git a/ccpp/suites/sandpiper.xml b/ccpp/suites/sandpiper.xml
index c263dc6a4..b16c2ccb1 100644
--- a/ccpp/suites/sandpiper.xml
+++ b/ccpp/suites/sandpiper.xml
@@ -1,9 +1,8 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!--
 DESCRIPTION:
-Suite "sandpiper" (formerly known as FV3_RAP_flake)
+Suite "sandpiper" (formerly known as FV3_RAP_flake) is identical to suite "albatross", but with the addition of the Freshwater Lake (FLake) model (http://www.flake.igb-berlin.de/site/doc) for simulating freshwater lake temperatures.
 -->
-
 <suite name="sandpiper" version="1">
   <!-- <init></init> -->
   <group name="time_vary">
diff --git a/ccpp/suites/shrike.xml b/ccpp/suites/shrike.xml
index 0931a49fe..5f334b004 100644
--- a/ccpp/suites/shrike.xml
+++ b/ccpp/suites/shrike.xml
@@ -1,9 +1,8 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!--
 DESCRIPTION:
-Suite "shrike" (formerly known as FV3_RAP_sfcdiff)
+Suite "shrike" (formerly known as FV3_RAP_sfcdiff) is identical to suite "albatross", but with the GFS surface layer scheme rather than the MYNN surface layer scheme.
 -->
-
 <suite name="shrike" version="1">
   <!-- <init></init> -->
   <group name="time_vary">
diff --git a/ccpp/suites/snowy_owl.xml b/ccpp/suites/snowy_owl.xml
index aab666bb5..dd90697cf 100644
--- a/ccpp/suites/snowy_owl.xml
+++ b/ccpp/suites/snowy_owl.xml
@@ -1,9 +1,8 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!--
 DESCRIPTION:
-Suite "snowy_owl" (formerly known as FV3_RAP_clm_lake)
+Suite "snowy_owl" (formerly known as FV3_RAP_clm_lake) was originally developed for research and prototyping of early UFS systems. It was meant to emulate the physics of the Rapid Refresh (RAP) model, though it had some differences from the operational implementation (which was not CCPP-based). This suite is identical to suite "albatross", but with the addition of the Community Land Model (CLM) lake model (as is found in the operational RAP).
 -->
-
 <suite name="snowy_owl" version="1">
   <!-- <init></init> -->
   <group name="time_vary">
diff --git a/ccpp/suites/starling.xml b/ccpp/suites/starling.xml
index e13be15b1..42487b3da 100644
--- a/ccpp/suites/starling.xml
+++ b/ccpp/suites/starling.xml
@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!--
 DESCRIPTION:
-Suite "starling" (formerly known as FV3_GFS_v16_ras)
+Suite "starling" (formerly known as FV3_GFS_v16_ras) is identical to suite "raven", but with the Relaxed Arakawa-Schubert Convection Scheme rather than the scale-aware mass-flux deep convection scheme.
 -->
 
 <suite name="starling" version="1">
diff --git a/ccpp/suites/tern.xml b/ccpp/suites/tern.xml
index c52df6eab..6fbe55f39 100644
--- a/ccpp/suites/tern.xml
+++ b/ccpp/suites/tern.xml
@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!--
 DESCRIPTION:
-Suite "tern" (formerly known as FV3_GFS_v17_p8_mynn)
+Suite "tern" (formerly known as FV3_GFS_v17_p8_mynn) was used for testing an early prototype of the Global Forecast System (GFS) version 17 release.
 -->
 
 <suite name="tern" version="1">
diff --git a/ccpp/suites/turnstone.xml b/ccpp/suites/turnstone.xml
index a592fb627..cece7291f 100644
--- a/ccpp/suites/turnstone.xml
+++ b/ccpp/suites/turnstone.xml
@@ -1,9 +1,8 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!--
 DESCRIPTION:
-Suite "turnstone" (formerly known as FV3_RAP_cires_ugwp)
+Suite "turnstone" (formerly known as FV3_RAP_cires_ugwp) is similar to "albatross" but using the CIRES Unified Gravity Wave Physics (version 0) rather than the GSL orographic gravity wave drag scheme.
 -->
-
 <suite name="turnstone" version="1">
   <!-- <init></init> -->
   <group name="time_vary">
diff --git a/ccpp/suites/wren.xml b/ccpp/suites/wren.xml
index 3605a0d23..db6421043 100644
--- a/ccpp/suites/wren.xml
+++ b/ccpp/suites/wren.xml
@@ -1,9 +1,8 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!--
 DESCRIPTION:
-Suite "wren" (formerly known as FV3_HRRR_c3)
+Suite "wren" (formerly known as FV3_HRRR_c3) is similar to suite "bald_eagle" but with the addition of the C3 Deep Convection scheme.
 -->
-
 <suite name="wren" version="1">
   <!-- <init></init> -->
   <group name="time_vary">