From: C. Scott Ananian <cscott@cscott.net>
Date: Tue, 5 Apr 2016 17:55:26 +0000 (-0400)
Subject: Improve comment to localizers in MessagesEn.php
X-Git-Tag: 1.31.0-rc.0~7373
X-Git-Url: http://git.cyclocoop.org/?a=commitdiff_plain;h=51d5d5deaf87888cd57f011642330590b17b044f;p=lhc%2Fweb%2Fwiklou.git

Improve comment to localizers in MessagesEn.php

Follow up to Ia670512e0cb375335873e7f9a08b638bbe039e45.

Bug: T116020
Change-Id: I8634585e52ce5339dbfcd5b19c5d1b6c9ef5687e
---

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
  */