diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 8fee55887..0375e073a 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -47,6 +47,14 @@ risk.
 
 Please never submit LLM-generated code as-is.
 
+### Kotlin and Compose migration
+
+Catima uses a lot of "legacy" tech, Java, Android XML. This will be ported to Kotlin,
+then Jetpack Compose; for further details, see
+<https://github.com/CatimaLoyalty/Android/issues/2483>.
+
+Thus, prefer Kotlin for new code where practical, especially new files/features.
+
 ### Test Your Code
 
 There are four possible tests you can run to verify your code.  The first