diff --git a/tools/README.md b/tools/README.md
index 8b509f8f4..c654936af 100644
--- a/tools/README.md
+++ b/tools/README.md
@@ -7,4 +7,10 @@ The scripts in this directory assume that your current working directory is the
 ## Pre-release checklist
 
 - [ ] Update compatibility list
-- [ ] Update translations
\ No newline at end of file
+- [ ] Update translations
+
+### Note:
+
+For reasons unknown, some part of the translation update process can inexplicably produce files with different content depending on the environment in which it is running, even when using the same version of the tool and the same distro.
+
+For consistency, when updating the translations to be committed to the repository, always perform the update within the the Docker environment we use for Azahar's CI (`opensauce04/azahar-build-environment:latest`).