Merge branch 'main' into probtest_santis

Author: AnnikaLau

docs/models/icon/SUMMARY.md

@@ -2,4 +2,5 @@
 * [Compile and Run](compile_and_run.md)
 * [Validate Custom Namelist](validate_custom_namelist.md)
 * [Run Probtest on Säntis](probtest.md)
-* [ICON-CLM](icon-clm.md)
+* [ICON-CLM](icon-clm.md)
+* [Known Bugs](known_bugs.md)

docs/models/icon/known_bugs.md

@@ -0,0 +1,33 @@
+# Known Bugs in ICON
+
+This document collects known build and runtime issues in ICON, including workarounds.
+If you encounter a new issue, please add it here so others can avoid debugging it again.
+
+## ecCodes compiles with GCC instead of NVHPC
+**Applies to**
+
+- Machine: Balfrin
+- Build: ICON compiled without emvorado
+
+**Symptom**
+
+- At runtime, you may see the cryptic error:
+```bash
+libgomp: TODO
+```
+or other strange runtime crashes.
+
+**Cause**
+
+- Due to a known bug in ICON’s build system (spack), eccodes is compiled with GCC instead of NVHPC if emvorado is not enabled.
+
+**Workaround / Fix**
+
+- In your spack.yml, explicitly require eccodes to be built with NVHPC:
+```bash
+- eccodes%nvhpc
+```
+
+**Status**
+
+- Known bug. Workaround required. Not yet fixed Spack.