linux-kernel - Re: [PATCH] Chinese translation of Documentation/HOWTO

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [<thread-prev] [thread-next>] [day] [month] [year] [list]

Message-Id: <200706221454.03926.rob@landley.net>
Date:	Fri, 22 Jun 2007 14:53:59 -0400
From:	Rob Landley <rob@...dley.net>
To:	Alan Cox <alan@...rguk.ukuu.org.uk>
Cc:	"dave young" <hidave.darkstar@...il.com>,
	"Li Yang" <leoli@...escale.com>, gregkh@...e.de,
	linux-kernel@...r.kernel.org, xiyou.wangcong@...il.com,
	bryan.wu@...log.com, "TripleX Chung" <xxx.phy@...il.com>,
	"Maggie Chen" <chenqi@...ondsoft.com>,
	torvalds@...ux-foundation.org
Subject: Re: [PATCH] Chinese translation of Documentation/HOWTO

On Friday 22 June 2007 05:21:23 Alan Cox wrote:
> > The question is, do the kernel developers want to encourage people who
> > don't speak English to mess with the kernel, any more than they want to
> > encourage kernel developers who don't know C?  Is kernel documentation in
> > Chinese a
>
> The majority of the world population do not speak English. There are
> existing contributors do not speak English (and I'm not being funny about
> the USSA here) - you don't notice because they have a team member who
> speaks passable English.

Ok.  Cool.  If this is not a problem, that's good to know.

> There are also entire non-English sites around things like Linux that
> monoglot English speakers generally don't notice exist.

I'm aware of this.

> > P.S.  The hardest part of putting together a kernel documentation web
> > page is actually indexing it coherently.  It's not very useful to just
> > dump together
>
> For the kernel I would follow the kernel tree so that its always
>
> 	/[languagecode]/Documentation/...

That PS was about putting up a kernel doc web page, not about the existing 
kernel Documentation tree.

The existing Documentation tree has, at the top level, coding style 
guidelines, files documenting the kernel community, a file documenting the 
Amiga "zorro" bus, a half-dozen files about old multiport serial cards, 
documentation about several different types of locking, a penguin graphic 
from 1996, your documentation on the tty layer, a document on how to 
configure BINFMT_MISC to autorun .NET files with mono, and zillions of other 
random unrelated topics that are sorted based on where random passerby put 
things down last.

I sent a couple patches to shuffle stuff around in there but it got lost on 
the noise.  More to the point, an HTML index can hotlink but text files have 
a harder time doing that, so if I'm making an HTML index it's probably best 
to link to the text files but not attempt to navigate with them.

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@...r.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html
Please read the FAQ at  http://www.tux.org/lkml/