Reviewer comments

README.md

@@ -22,3 +22,13 @@ Thermodynamics.jl provides flexible and performant functions for computing vario
 [codecov-url]: https://codecov.io/gh/CliMA/Thermodynamics.jl
 
 See our documentation [here](https://clima.github.io/Thermodynamics.jl/dev/index).
+
+Thermodynamics is used by several CliMA components, including:
+
+ - [ClimaAtmos](https://github.com/CliMA/ClimaAtmos.jl)
+ - [ClimaLand](https://github.com/CliMA/ClimaLand.jl)
+ - [ClimaOcean](https://github.com/CliMA/ClimaOcean.jl)
+ - [ClimaCoupler](https://github.com/CliMA/ClimaCoupler.jl)
+ - [CloudMicrophyiscs](https://github.com/CliMA/CloudMicrophysics.jl)
+ - [SurfaceFluxes](https://github.com/CliMA/SurfaceFluxes.jl)
+ - [KinematicDriver](https://github.com/CliMA/KinematicDriver.jl)

docs/src/index.md

@@ -82,8 +82,9 @@ using the functions, e.g., for the energies in the module, and computing
 the temperature `T` and the liquid and ice specific humidities (`q.liq` and
 `q.ice`) from the internal energy `e_int` by saturation adjustment.
 
-## Usage
+## Dycore pseudo code
 
+Here, we outline how users might use Thermodynamics inside a circulation model.
 Users are encouraged to first establish a thermodynamic state with one of our
 [Thermodynamic State Constructors](@ref). For example, we would construct
 a moist thermodynamic state using