A bit of ranting about Ubuntu.com

[Peter Garrett]

On Mon, 06 Feb 2006 14:30:35 +0000
Derek Broughton <news at pointerstop.ca> wrote:

> 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.

Yes, you're probably right.... my apologies John, if I misunderstood.
> 
> >> 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.  

Actually I meant more " I wasn't meaning to be taken literally regarding
my comments, "including but not limited to" :

"Most people, when they see the word "Documentation" think something like
"Scary techno-babble I won't understand". "

So...  storm in a teacup really ;-)

> 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.

Especially with computers, since they are the greatest pedants and
sticklers for accuracy of all ;-) 

Disclaimer: I try not to anthropomorphise computers - they really hate
it 
:-)

Peter