Re: [SLE] Comment about Documentation on Linux

...

...

...

...

"adhak" == adhak writes: <>

adhak> be done for configuration. The documentation support for adhak> Windows is much more organised and well written but this is adhak> another story. I also don't understand why documentation adhak> concerning installation of server services is absent most adhak> of the times. I urge people writing documents to do their adhak> best in being more precise about how to do the preleminary adhak> installation before moving to other much more sophisticated adhak> options to avoid mixing necessity with luxury. This is the only part I'd have to disagree with... MS Dos 5.0 came with a great manual - huge, detailed, very well written. MS Dos 6 & 6.2 came with little 50-page 'guides' Windows 3.1 came with a great manual, also huge and full of good detail. Windows 95 came with a 'getting started' guide, as did Windows 98, and NT 4. That's not enough docs for anyone. So, if you are really interested in good documentation for *anything* on the computer these days, you need to head over to http://www.fatbrain.com (or your favorite on-line or brick-and-mortar bookseller) and drop some money. If you do that, you'll do great. Personally, I think that the manual I got when I bought SuSE 6.4 off the shelf was the best *included* documentation I've seen since MS Dos 5.0. There is even a silly little click and point style install guide for those folks more accustomed to MS systems. But the real manual has great info about how they layed out the file systems, and all kinds of great stuff about the different programs that most of us normally need. The documentation is there. It's only as good as the folks who write the software make it. Since most of the software we use on Linux systems is free, that means the documentation is also provided by the same group of volunteers. If you want good docs, pay for them. If you want really good docs, read the source code. You can't compare the documentation from MS with the docs on *NIX systems. take a good look at the difference between *click* Start, *click* Help and 'apropos sh'. Choose the style that works best for you, and stick with it. If you think you've hit on a better way to do something than what is included in the packaged docs, write up a FAQ or How-To and plunk it on a web page. Everyone would be glad to see it. --tag -- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Timothy A. Gregory tgregory@tarjema.com *NIX Systems Admin Arabic Translator finger tgregory@tarjema.com for my GnuPG Key -- To unsubscribe send e-mail to suse-linux-e-unsubscribe@suse.com For additional commands send e-mail to suse-linux-e-help@suse.com Also check the FAQ at http://www.suse.com/Support/Doku/FAQ/