On Thu, 2 Aug 2007 22:41:50 -0400 Rob Landley wrote: > This month I participated in several long threads about translating kernel > documentation into other languages, primarily Japanese and Chinese. (I cc'd > some but not all of them here.) > > http://kernel.org/doc now links to the websites http://www.linux.or.jp and > http://zh-kernel.org, which are respectively japanese and chinese linux > kernel communities that have offered to translate documentation. (I asked if > it made more sense to link directly to the documentation or to the top level > communities, and was consistently told the top level.) > [snip] > > Another issue is keeping translations up to date. On the advice of Eric > Raymond, I'm not hosting translated copies but instead linking to copies put > on the web by the translators. Eric has found that if he hosts translations > of his writings, they never get updated. If he links to translations hosted > by the translators, they get updated. > > I also don't recommend checking translated documentation into the kernel > tarball, but that isn't my call. I notice that Greg KH disagrees with > basically every issue I've ever talked to him about. I haven't tried reverse > psychology on him yet to see if it's causal, but see > http://lwn.net/Articles/242541/ and note that I expect it to be merged. > *shrug* Oh well. (I'm not maintaining it, I can't even read it. Not my > problem.) Has been merged. FWIW, I agree that the translations are better kept outside the kernel tree, at various language-specific sites. > Another issue is which documentation to translate? The primary goal is to > translate the community documentation; many developers have some technical > English but get hung up on cultural issues. I proposed a list (see > http://lkml.org/lkml/2007/7/12/243 ), which seems to have been accepted (with > a few corrections) as a reasonable starting point. Just policy docs, not technical ones, right? Problem is that some of them cross those lines (i.e., it's not a black/white question). --- ~Randy *** Remember to use Documentation/SubmitChecklist when testing your code *** - To unsubscribe from this list: send the line "unsubscribe linux-doc" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html