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

[S Page]

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.

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

--
=S Page  software engineer on E3