Re: Documentation of kernel messages (Summary)

From: Rob Landley
Date: Mon Jul 09 2007 - 12:48:42 EST


In regard to translating kernel messages:

On Monday 09 July 2007 01:36:31 H. Peter Anvin wrote:
> Kunai, Takashi wrote:
> > (1) Your kernel development proposal will be greatly supported by
> > Japanese vendor community. At the same time, it needs support from the
> > kernel communities, as well.
>
> There is a very strong reason for the kernel community to NOT support
> this: it makes it much harder to deal with bug reports.

Agreed.

There's a proposal in play for translations of documentation, and to
recruit "language maintainers" (which is an idea I see that Matt Mackall came
up with before I did).

A language maintainer is somebody who can accept a patch in language X,
translate its description to post on the appropriate english-only list with a
cc: to the appropriate maintainer(s), and translate questions and reviews
back and forth for the original author until the patch can be merged. (This
means that documentation translations don't result in a stream of unmergeable
patches.)

As for the documentation translations themselves, I note that Eric Raymond
dissuaded me from actually hosting translations of kernel documentation on
http://kernel.org/doc due to his experience with translations of his own
writings. If he hosts the translations on his website, they never get
updated again. But if he makes the contributor host them on their own
website, then they sometimes get updated.

For my part, I can't _tell_ when a given translation is out of date because I
can't read it, and I certainly can't update it. So I agree with Eric and I'm
linking to sites hosting kernel documentation in other languages rather than
hosting them myself. I've got a good link to a Japanese site, need to ping
the contributors of the chinese documentation and see if they have a site for
it...

I await hearing back from Satoru Ueda who might have a lead on a potential
Japanese maintainer, probably after some event in Japan (a "Jamboree") in a
week or two...

Rob
--
"One of my most productive days was throwing away 1000 lines of code."
- Ken Thompson.
-
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at http://vger.kernel.org/majordomo-info.html
Please read the FAQ at http://www.tux.org/lkml/