Hands-on-ICON-data-analysis-for-beginners.md

@@ -243,7 +243,7 @@ eeriecat=https://raw.githubusercontent.com/eerie-project/intake_catalogues/main/
 
 > **Ruby**
 
-- `query_yaml -c ${rubycat}` will list a hierarchy of simulations (data tree structure included) that is on the specified catalogue. 
+- `query_yaml -c ${rubycat}`  or  `query_yaml --ruby` will list a hierarchy of simulations (data tree structure included) that is on the specified catalogue. For all query_yaml examples using ruby catalogue, you can substitute `-c ${rubycat}` with `--ruby`.
 
     <details><summary>text dump snippet from "query_yaml -c ${rubycat}" </summary>
     
@@ -1784,13 +1784,14 @@ data.tas.isel(cell=pix).sel(time="2020-09-30").plot(
 </details>
 
 ## Caveats in ICON
-Honorable mentions on some caveats in ICON that may matter for the analysis.
+Honourable mentions on some caveats in ICON that may matter for the analysis.
 
 1) 3D **time-mean** atmospheric output on model levels only. See next section to [interpolate to pressure level](#Interpolating-from-model-levels-to-pressure-levels)
-2) Time shift in output (e.g. `cdo -shifttime,-14days` for monthly files)
+2) Time shift in output (e.g. `cdo -shifttime,-15days` for monthly files)
 3) For sea surface height, better to use `ssh` instead of `zos`, especially under sea-ice
 4) ICON-A is non-hydrostatic, be careful with conversion of wa to omega
-5) Ocean has time-variant vertical coordinate system (zstar)
+5) For ocean mixed layer depth, `mld` was for CMIP5 and before. `mlotst` is used for CMIP6 onwards. `mlotst10` uses 10m depth temperature instead of SST as reference. 
+6) Ocean has time-variant vertical coordinate system (zstar)
 
 ## Atmospheric 3D variables