HACKING: Add section for tips on reducing translator workload.
authorBo Borgerson <gigabo@gmail.com>
Mon, 16 Jun 2008 22:30:25 +0000 (18:30 -0400)
committerJim Meyering <meyering@redhat.com>
Tue, 17 Jun 2008 06:29:23 +0000 (08:29 +0200)
* HACKING (Be nice to translators): New section.
Add Jim's suggestion to avoid changing translatable strings if possible.

HACKING

diff --git a/HACKING b/HACKING
index 4363418..07026b1 100644 (file)
--- a/HACKING
+++ b/HACKING
@@ -273,6 +273,15 @@ Write "Type const *var", not "const Type *var".
 FIXME: dig up justification
 
 
+Be nice to translators
+======================
+Don't change translatable strings if you can avoid it.
+If you must rearrange individual lines (e.g., in multi-line --help
+strings), extract and create new strings, rather than extracting
+and moving into existing blocks.  This avoids making unnecessary
+work for translators.
+
+
 Add tests
 ==========
 Nearly every significant change must be accompanied by a test suite