On 20/11/09 00:20, Peter Nikolic wrote:
On Thursday 19 Nov 2009 12:53:19 Basil Chupin wrote:
[pruned]
And to top it all all off, manuals are written for those people who already KNOW about the subject; manuals are NOT written to provide the novice with the necessary information to resolve his/her query. Known fact in the environment where non-programmers have to deal with programmers - as I did. Look at the "man pages", generally. How many actually give you an example, a clear-cut, simple example(s), which shows "if you want to do this then type this on the command line"? :-)
BC
Well said Basil this has been stated many times before but still you get the read the man page or even worse the RTFM boys offering what amounts to a big fat ZERO when it comes to constructive assistance , This seems to be an side effect of Opensuse these days.
Not just confined to oS, Pete. Been so for decades :-( and for various software. If you find some decent documentation written for a piece of software I will bet you pounds to peanuts that the documentation was written not by the programmer(s) but by a team of specialists employed to just write documentation. Besides, I have a tagline (which I cannot find at the moment) which goes something like this, "I olwais wonted too bee a progremer and naw i is won!". (Perhaps we should be grateful for small mercies :-) .) BC -- I work to live not live to work. -- To unsubscribe, e-mail: opensuse+unsubscribe@opensuse.org For additional commands, e-mail: opensuse+help@opensuse.org