A bit of ranting about Ubuntu.com

[Derek Broughton]

Peter Garrett wrote:

> On Mon, 06 Feb 2006 21:53:55 +0800
> John <dingo at coco2.arach.net.au> wrote:
> 
>> Don't patronise.
> 
> i wasn't
> 
I doubt he was accusing you - I think it's just documentation truisms.

>> Use Plain English.
> 
> I agree
> 
>> Try to be clear and accurate.
> 
> Try to think metaphorically rather than literally

I'm not sure whether that's supposed to apply to the documentation reader or
writer, but I really think you shouldn't, in either case.  Though my wife
(unfairly :-)) accuses me of being a literalist, she really can't handle a
metaphorical manual.  Some people have to have literal instructions.
-- 
derek