Hi,
The JSON i18nj files in MediaWiki extensions are getting filled by apihelp
messages. They are usually added to the end of the files.
In addition to docs internationalization, which is pretty awesome by
itself, this happens to have another somewhat useful side effect on the
i18n files themselves. Most messages that are added to the JSON files are
not apihelp messages. When messages are added to the end of the file, a
comma must be added to the last JSON line, even if the message on that line
doesn't actually change. This change is not really meaningful, but it adds
one more line to the diff in review.
Keeping the apihelp messages in the end and adding all other messages
before them prevents this comma-adding and shortens the diff by one line.
It is, of course, a small thing, but it saves a few moments when reviewing
code or doing git blame or git bisect.
I suggest adopting this as a good practice.
--
Amir Elisha Aharoni · אָמִיר אֱלִישָׁע אַהֲרוֹנִי
http://aharoni.wordpress.com
“We're living in pieces,
I want to live in peace.” – T. Moore