Download your favorite Linux distribution at LQ ISO.
Go Back > Forums > Linux Forums > Linux - Newbie
User Name
Linux - Newbie This Linux forum is for members that are new to Linux.
Just starting out and have a question? If it is not in the man pages or the how-to's this is the place!


  Search this Thread
Old 09-12-2002, 09:54 AM   #1
LQ Newbie
Registered: Sep 2002
Posts: 1

Rep: Reputation: 0
Linux software documentation

What is your opinion about documentation suplied with (free) linux Software ?
I think that it's very cryptic, not user friendly and often obsolete.
When I lose 2 days to setup simple thing like MySQL server because of inaccurate documentation it is very annoying. And similar happened many times.
Can it be better ? How it affects popularity and spread of Linux Worldwide ?
Old 09-13-2002, 01:25 AM   #2
LQ Guru
Registered: Mar 2002
Location: Salt Lake City, UT - USA
Distribution: Gentoo ; LFS ; Kubuntu
Posts: 12,612

Rep: Reputation: 69
I think it's only cryptic to those unfamiliar with some Linux programs. I do think that authors assume alot when writing it (not all of course, this is very vague, and not all inclusive), but try to make the documentation as best and fullfilling as possible. I do not think that they would want to write a program, make it fully available for anyone, and then make the documentation unreadable by it's users, at least not on purpose.

Yes it can be better, and does get better. Many people can add to documentation, including yourself. Subscribe to the mailing lists, email the authors, and let them know you would like to help improve the documentation. One of the nice things about open source is that anyone can help, not just programmers.



Thread Tools Search this Thread
Search this Thread:

Advanced Search

Posting Rules
You may not post new threads
You may not post replies
You may not post attachments
You may not edit your posts

BB code is On
Smilies are On
[IMG] code is Off
HTML code is Off

Similar Threads
Thread Thread Starter Forum Replies Last Post
software for network documentation ddaas General 2 02-08-2005 03:49 AM
looking for linux documentation Idiotnewb Linux - Newbie 3 02-29-2004 08:34 PM
Linux Documentation Hmmyah Linux - General 3 12-09-2003 05:53 PM
Linux Documentation linuxturtle Linux - General 5 08-10-2003 10:54 PM
Linux documentation GtkUser General 6 01-30-2003 02:51 PM > Forums > Linux Forums > Linux - Newbie

All times are GMT -5. The time now is 07:35 AM.

Main Menu
Write for LQ is looking for people interested in writing Editorials, Articles, Reviews, and more. If you'd like to contribute content, let us know.
Main Menu
RSS1  Latest Threads
RSS1  LQ News
Twitter: @linuxquestions
Open Source Consulting | Domain Registration