[Mediawiki-i18n] Why why /** Message documentation (Message documentation)?

[Niklas Laxström]

On 15 June 2013 00:11, S Page <spage at wikimedia.org> wrote:
> On Tue, Jun 11, 2013 at 11:53 PM, Niklas Laxström
> <niklas.laxstrom at gmail.com> wrote:
>>
>> For all other languages the tools regenerates the sections from
>> scratch which makes them all use consistent format.
>
>
> Ahh, so it more or less doesn't matter what's in the i18n.php section
> headings since the tools rebuild the file. I expanded this step in
> <https://www.mediawiki.org/wiki/Localisation#Update_of_localisation>.
> I'm not sure it's worth telling people not to worry about something
> they may never notice  :-) .
>
> Another question: I add my name in @author comments to the 'en' and
> 'qqq' section headings.  Should I instead just put it in the doc
> comments at the top of the file? (I authored the file so obviously I
> did those sections.)  Presumably "the tools" add other names when they
> generate from translatewiki.

Usually people add themselves to 'en' and 'qqq' if they bother at all.
The tool will add user names from translatewiki.net automatically and
retain existing @author tags.

> Thanks, it's a huge piece of infrastructure that works so well we
> don't think about it.

Awesome.

  -Niklas