Flammie Pirinen wrote:
> (I apologize handmade quotation, sylpheed-claws seems to dislike the original message so much that I can't reply to it directly)
No problem at all, luckily I use a /modern/ emailer ;-) and quoted bits are
> Xavier Neys wrote:
>>Hi Santtu, Flammie,
>>Santtu, Thanks a lot for your translations.
>>Please do not post them to the ML. Submit them to bugs.gentoo.org >instead.
> I apologize. I thought I could transfer the QA discussion of documentation away from unuseful phpbb forums to the Mailing List, but if this is not desired, then I'll just restrict it to IRC and private mail. You can also delete this list since, as it can't be used for discussion concerning the documentation it will be rather pointless, I apologize the inconvenience, I should have stated the meaning of the list I required more clearly.
*Disccussing* the translations is exactly what the ML is for. Howewer, it is
not meant to receive full docs. Please remember that third-parties archive our ML.
forums.g.o is for all Gentoo users to talk in Finnish about Gentoo and other
topics if they want to. It is a 100% user-based community. Discussions about
translations have very little added value for users. What they want is the
result under /doc/fi/ ;-)
>>An unspoken convention is to put [FI] (or any other language code) at >the
>>beginning of the title to let other docdevs know the bug entry is >about/in
> Yes, I have already used the [Finnish] tag which I picked up from some other translation I found, I'll change it for the next submission.
[Finnish] is even more explicit and is OK if you don't mind typing it.
>>If you feel the translation needs more comments or reviews, please post >a note
>>on the ML with a link to the bug entry so it can be discussed here.
> Heh, I don't think it's worth of extraneous mechanism of mailing lists just to inform people about bug numbers. I'm gonna take a big guess and assume that anyone who has enough time to make constructive criticism on documentation has to be capable of using the query button of bugzilla as well.
I think that 1 (one) translator posting 1 (one) message to let fellow
translators know about 1 (one) submitted translation when he feels extra QA is
required is more user-friendly than everyone having to poll bugs.g.o just in
case there is anything that might interest them.
>>BTW, the inserted texts like 'Update', 'Content', 'Note'... have been
>>translated but will be used only if the lang="fi" attribute is added to >the
> Ok. It might also be useful if this was stated somewhere in the documentation or somewhere, or it could be that I have just missed it.
You haven't missed it. It should be properly documented indeed. I'll see to
it. Thanks for making me notice.
> So just a clarification to Finnish doc team, please send the first drafts of your translations directly to bugzilla, we'll be spamming the bugzilla with the updates until documentation is ready and valid, and discussion continues in the forums and IRC like before creation of this list. I apologize the inconvenience.
That's hardly any spam at all. This is what bugs.g.o is for.
This is what I believe should be the shortest path to process a translation:
1) Translator decides to translate a doc and notifies others via the ML
2) Translator posts translation to bugs.g.o
3) Lead Translator reviews, edits and commits the translation
At step 2), translator may want to notify others via ML e.g. to request more
QA. Committing the translation does not stop the QA process nor any possible
discussions, it simply means the Lead Translator thinks the translation is
good enough to go public.
The ML is used whenever a translator has difficulties translating parts of a
document, needs any kind of help or wants to share any useful bit of
information about the translations. It is also used by the Lead & Follow-Up
translators to notify translators of any changes, to ask for help, to announce
In short, files & patches go to bugs.g.o and discussions of all kinds go to
Sorry about the different usages not being explicit enough.
Feel free to comment/send feedback/complain/ask questions...
With kind regards,
/ Xavier Neys
\_ Gentoo Documentation Project
/ French & Internationalisation Lead