From: Seth Kurtzberg Date: 2003-03-09T14:20:32+09:00 Subject: Re: Solving the 'strange language' documentation problem On Saturday 08 March 2003 10:15 pm, Hal E. Fulton wrote: > ----- Original Message ----- > From: "TAKAHASHI Masayoshi" > To: "ruby-talk ML" > Sent: Saturday, March 08, 2003 6:49 PM > Subject: Re: Solving the 'strange language' documentation problem > > > IMHO, what we need is 'Writing documents in English > > for dummies' or 'Teach yourself Reference Manual in 21 days' > > or 'Writing English Document: The Pragmatic Programmer's Guide'. > > And then let Japanese developers read them. I can help with this also. However, no "dummies." I've always wondered exactly why anyone would read a "dummies" book. In any event, I doubt very much anyone on the ruby list qualifies as a dummy. > > > > There are a lot of textbooks and guides of writing, but they > > are too general purpose. I want to read more specific one, > > focused on documents for library of programing language. > > > > * template of documents > > * list of keywords frequently used in documents like > > README, reference manual and tutorial > > * list of common expressions (and thesaurus?) > > * ...and so on > > > > It's not problem whether it is written in English or Japanese. > > If it's written English, It's useful for not only Japanese, > > but other language speakers. > > > > Does anyone know such documents? > > If one does not exist, maybe we can make one. > I will assist if you are interested. > > Hal -- Seth Kurtzberg M. I. S. Corp. 480-661-1849 seth@cql.com