LinuxQuestions.org
Share your knowledge at the LQ Wiki.
Go Back   LinuxQuestions.org > Forums > Linux Forums > Linux - Newbie
User Name
Password
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!

Notices


Reply
  Search this Thread
Old 09-12-2002, 10:54 AM   #1
ppera
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, 02:25 AM   #2
MasterC
LQ Guru
 
Registered: Mar 2002
Location: Salt Lake City, UT - USA
Distribution: Gentoo ; LFS ; Kubuntu
Posts: 12,612

Rep: Reputation: 64
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.

Cool
 
  


Reply


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 04:49 AM
looking for linux documentation Idiotnewb Linux - Newbie 3 02-29-2004 09:34 PM
Linux Documentation Hmmyah Linux - General 3 12-09-2003 06:53 PM
Linux Documentation linuxturtle Linux - General 5 08-10-2003 11:54 PM
Linux documentation GtkUser General 6 01-30-2003 03:51 PM


All times are GMT -5. The time now is 05:57 PM.

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