On Thursday 19 Nov 2009 13:48:50 Basil Chupin wrote:
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
Well you never know one of these days Eh is it too much to ask for Useable documentation for the newer and less tech users seems it is and always has been Pete . -- Powered by openSUSE 11.2 Milestone 2 (x86_64) Kernel: 2.6.30-rc6-git3-4- default KDE: 4.2.86 (KDE 4.2.86 (KDE 4.3 >= 20090514)) "release 1" 14:21 up 11 days 23:47, 3 users, load average: 0.39, 0.38, 0.43