discuss: LDP Style discussion (cont.)
Subject:
Re: LDP Style discussion (cont.)
From:
"M. Leo Cooper" ####@####.####
Date:
9 Apr 2002 18:42:02 -0000
Message-Id: <Pine.LNX.4.33.0204091117370.1381-100000@localhost.localdomain>
On Mon, 8 Apr 2002, Charles Curley wrote:
> After reading this, let me refer everyone to "Read Me First! A Style
> Guide for the Computer Industry", by Sun Technical Publications, First
> edition, 272 pages, ISBN 0-13-455347-0,
> http://www.sun.com/books/catalog/EdStyle/index.html. I just read it,
> and found it to be an excellent reference book. Both professional and
> amateur writers can benefit from it.
I looked at its TOC, and frankly I'm not all that sure that this type of style
guide is something for LPD authors to emulate. It appears to be a recipe for
corporate-speak, for writing the type of manuals that gather dust on the shelf
and that no sane person would read.
" * Avoid Humor 2 "
I guess that leaves my documents out...
I'd instead recommend the "bible" of good writing, Strunk & White's ELEMENTS
OF STYLE, as a starting point.