From 51d5d5deaf87888cd57f011642330590b17b044f Mon Sep 17 00:00:00 2001 From: "C. Scott Ananian" Date: Tue, 5 Apr 2016 13:55:26 -0400 Subject: [PATCH] Improve comment to localizers in MessagesEn.php Follow up to Ia670512e0cb375335873e7f9a08b638bbe039e45. Bug: T116020 Change-Id: I8634585e52ce5339dbfcd5b19c5d1b6c9ef5687e --- languages/messages/MessagesEn.php | 13 +++++++++---- 1 file changed, 9 insertions(+), 4 deletions(-) diff --git a/languages/messages/MessagesEn.php b/languages/messages/MessagesEn.php index 23f2bb02d5..674be133b2 100644 --- a/languages/messages/MessagesEn.php +++ b/languages/messages/MessagesEn.php @@ -198,10 +198,15 @@ $bookstoreList = [ * CASE is 0 to match all case variants, 1 for case-sensitive * * Note to localisers: - * - Include the English magic words as synonyms. This allows people from other - * that do no speak the language to contribute more easily. - * - Order the aliases so that common aliases are occur before more rarely - * used aliases. Tools are expected to use the first alias. + * - Include the English magic words as synonyms. This allows people from + * other wikis that do not speak the language to contribute more easily. + * - The first alias listed MUST be the preferred alias in that language. + * Tools (like Visual Editor) are expected to use the first listed alias + * when editing or creating new content. + * - Order the other aliases so that common aliases occur before more rarely + * used aliases. The aliases SHOULD be sorted by the following convention: + * 1. Local first, English last, then + * 2. Most common first, least common last. * * This array can be modified at runtime with the LanguageGetMagic hook */ -- 2.20.1