A bit of ranting about Ubuntu.com
peter.garrett at optusnet.com.au
Mon Feb 6 15:39:34 GMT 2006
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
More information about the sounder