Re: Documentation of kernel messages (Summary)

From: Gerrit Huizenga
Date: Mon Jul 09 2007 - 13:18:45 EST



On Mon, 09 Jul 2007 12:48:24 EDT, Rob Landley wrote:
> 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.

[...]

>
> 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...

Yeah, but it seems like having a translations directory in the kernel
avoids that problem - anyone can update, it is a single source, no digging
for sites that aren't tied to the kernel, available in the distros
directly, etc.

I'm not sure that the web site hosting argument is a good one. Arch
maintainers and Language Maintainers have some similarities. Also, being
able to clearly mark which version of a document was last translated
would help a bit with the fact that most of us aren't proficient in all
of the world's languages. But, knowing who the translation maintainer is,
and when the translation was last updated allows both the original doc
maintainer and the translation document maintainer to see when a document
likely needs to be updated. And that is probably good enough.

gerrit
-
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/