From 10698036810fcaeba9a1fbbc936d83682a5fc09e Mon Sep 17 00:00:00 2001
From: IlyaZar <zarubin@wiso.uni-koeln.de>
Date: Mon, 6 Jul 2026 16:04:36 +0200
Subject: [PATCH] docs: note on migration for contributors

wording might be improved
---
 CONTRIBUTING.md | 8 ++++++++
 1 file changed, 8 insertions(+)

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