LinuxQuestions.org

LinuxQuestions.org (/questions/)
-   Linux - Newbie (https://www.linuxquestions.org/questions/linux-newbie-8/)
-   -   Linux software documentation (https://www.linuxquestions.org/questions/linux-newbie-8/linux-software-documentation-30195/)

ppera 09-12-2002 09:54 AM

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 ?

MasterC 09-13-2002 01:25 AM

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


All times are GMT -5. The time now is 01:59 AM.