From: Seth Kurtzberg <seth@...>
Date: 2003-03-10T03:57:14+09:00
Subject: Re: Solving the 'strange language' documentation problem

On Sunday 09 March 2003 11:49 am, Mike Campbell wrote:
> > > 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'd think a few of the native English speakers would do well by reading
> > > them also.
> >
> > Hey, like, you mean, ugh, we don't, like, talk too, uh, good?
>
> Even those who talk well can write like crap, and I'm not excluding myself
> from that group.

That is quite true.  I've seen documents written by brilliant people that were 
incomprehensible (the documents, not necessarily the people).

-- 
Seth Kurtzberg
M. I. S. Corp.
480-661-1849
seth@cql.com