From: Josef 'Jupp' Schugt <jupp@...>
Date: 2003-03-10T09:27:54+09:00
Subject: Re: Solving the 'strange language' documentation problem

EHLO

* On 2003-03-09 23:24
* Seth Kurtzberg <seth@cql.com> wrote:
> I've seen documents written by brilliant people that were
> incomprehensible (the documents, not necessarily the people).

One problem with doucments is that there is a culture of "the more
involved the sentences the better the document".

I own a nice book on writing theses natural sciences/engineering
(unfortunately in German). Becaus a large portion of such theses is
documentation of what one has done I am pretty sure that many of the
hints are useful for other documentations as well. I'll look into
that.

Josef 'Jupp' Schugt <jupp (at) gmx.de>            http://jupp.tux.nu/