RE: Documentation of kernel messages (Summary)

[Li Yang-r58472]

> -----Original Message-----
> From: linux-kernel-owner@xxxxxxxxxxxxxxx
> [mailto:linux-kernel-owner@xxxxxxxxxxxxxxx] On Behalf Of Rob Landley
> Sent: Tuesday, July 10, 2007 12:48 AM
> To: H. Peter Anvin
> Cc: Kunai, Takashi; holzheu@xxxxxxxxxxxxxxxxxx; Andrew Morton;
> linux-kernel@xxxxxxxxxxxxxxx; lf_kernel_messages@xxxxxxxxxxxxxxxxxxxx;
> mtk-manpages@xxxxxxx; jack@xxxxxxx; randy.dunlap@xxxxxxxxxx;
gregkh@xxxxxxx;
> pavel@xxxxxx; tim.bird@xxxxxxxxxxx; gh@xxxxxxxxxx;
arjan@xxxxxxxxxxxxx;
> sam@xxxxxxxxxxxx; jengelh@xxxxxxxxxxxxxxx; joe@xxxxxxxxxxx;
> auke-jan.h.kok@xxxxxxxxx; hansendc@xxxxxxxxxx; davem@xxxxxxxxxxxxx;
> Valdis.Kletnieks@xxxxxx; kenistoj@xxxxxxxxxx; schwidefsky@xxxxxxxxxx;
> heiko.carstens@xxxxxxxxxx; linux-doc@xxxxxxxxxxxxxxx
> Subject: Re: Documentation of kernel messages (Summary)
> 
> 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.

If the documents are already maintained together on one site, it won't
be very hard to synchronize with kernel.org.  Eric is right for the case
that separate documents on separate sites.

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

Please add a link to http://zh-kernel.org/docs for Chinese translated
kernel documentation.

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