On 11/19/2012 11:44 AM, Anton Aylward wrote:
The issue with the {expletive deleted} manuals is that for a non-technical, ignorant, noob they are not written well. Most are written by the person that does the programming [ or at least that is my impression ]. The person my be the most fantastic, super, programmer in the world but they can't write manuals that non-technical, ignorant, noobs can understand. Once again I say that you have confused purpose. The manuals are a technical reference and are meant to be a minimalist
Billie Walsh said the following on 11/19/2012 11:19 AM: though sometimes of necessity there is a lot to document) one in a very prosaic and fixed format. They are not meant to be how-to guides. Since you are complaining that they are dry, technical and not in literate English, then they meet their design constraints and I feel that is good. The problem is that you are expecting MAN pages to be something they are not, and that his 'how-to' guides, ones that lead you though "Frequent Used Examples".
But, time after time when someone like me posts a question about something the first thing that is posted is to either "RTFM" [Read The Fine Manual ], or to do a "man [whatever]". As a general rule neither of those answers is helpful and a complete waste of bandwidth. I can't speak for everyone else in the world, but if I ask a question about 99.99% of the time I have googled, and all the other banal answers, and I'm still stuck. -- “The only difference between death and taxes is that death doesn't get worse every time Congress meets.” — Will Rogers _ _... ..._ _ _._ ._ ..... ._.. ... .._ -- To unsubscribe, e-mail: opensuse+unsubscribe@opensuse.org To contact the owner, e-mail: opensuse+owner@opensuse.org