PCLinuxOS-Forums
News: ...FLASH!!! ...New PCLinuxOS Testing board now open. Register today! Be an active contributor to the PCLinuxOS future! ... Read all about it now, on THIS forum!!!..
 
*
Welcome, Guest. Please login or register. May 26, 2012, 03:22:38 PM


Login with username, password and session length


Pages: [1]   Go Down
  Print  
Author Topic: Why open source documentation lags  (Read 699 times)
menotu
PCLinuxOS Tester
Super Villain
*******
Offline Offline

Posts: 11986

┌∩┐(◕_◕)┌∩┐


« on: May 18, 2010, 06:21:56 AM »

http://www.zdnet.com/blog/open-source/why-open-source-documentation-lags/6484?utm_source=feedburner&utm_medium=feed&utm_campaign=Feed%3A+zdnet%2Fopen-source+%28ZDNet+Open+Source%29
Logged

If you can keep you head while all around you are losing theirs, then you have misunderstood the situation.

PCLinuxOS 32bit & 64bit; 3.2.17bfs kernel, KDE 4.8.3; nvidia 295.53, Athlon 64 X2 4200+; 4GB Ram; NVidia GeForce 8400GS 1GB; x.org 1.10.4 ; 500GB/320GB
parnote
PCLinuxOS Tester
Hero Member
*******
Offline Offline

Posts: 3967


The truth is out there ... PCLinuxOS!


« Reply #1 on: May 18, 2010, 07:02:48 AM »

Interesting find, menotu. As someone who has written some program documentation, I can attest that it is a rather arduous task to write intelligible, helpful documentation.

parnote
Logged

PCLinuxOS Magazine Chief Editor

Linux Registered User #485009

In a world without walls, who needs Windows?

PCLinuxOS Wiki: Contribute tips/tricks/how-to's!
menotu
PCLinuxOS Tester
Super Villain
*******
Offline Offline

Posts: 11986

┌∩┐(◕_◕)┌∩┐


« Reply #2 on: May 18, 2010, 07:08:29 AM »

I thought you'd find it of interest Parnote.
Logged

If you can keep you head while all around you are losing theirs, then you have misunderstood the situation.

PCLinuxOS 32bit & 64bit; 3.2.17bfs kernel, KDE 4.8.3; nvidia 295.53, Athlon 64 X2 4200+; 4GB Ram; NVidia GeForce 8400GS 1GB; x.org 1.10.4 ; 500GB/320GB
Village Idiot
Hero Member
*****
Offline Offline

Posts: 2355


Have A Nice Day.


« Reply #3 on: May 18, 2010, 02:40:50 PM »

I'm sorry, but I don't agree.  Embarrassed

PcLinuxOS has very good documentation that is hardwired into the install that points you to the wiki, forum and other useful information. I never received any manual for my copy of XP that came with the eee-pc. A few pages of basic usage and that was it- after that the user is on his own. To install the PcLinuxOS, the information is there in the same location. If I had to redo my winxp, I need to aggregate information from three or four different sources and even then I'd be flying blind.

Secondly, just about every program I use has either a man page or a --help I can punch in. This is non-existent elsewhere.

If anything there is too much information on the man pages, I'd actually prefer to see examples and a short explanation of each one rather than the giant list of switches you get.

jmo. I'm probably wrong.  Tongue
Logged

$ fortune
No Microsoft products were used in any way for the creation of this message.
If you are using a Microsoft product to view it, BEWARE! - I'm not
responsible for any harm you might encounter as a result.
menotu
PCLinuxOS Tester
Super Villain
*******
Offline Offline

Posts: 11986

┌∩┐(◕_◕)┌∩┐


« Reply #4 on: May 18, 2010, 02:45:59 PM »

This wasn't a reference to PCLinuxOS in any way whatsoever.
Logged

If you can keep you head while all around you are losing theirs, then you have misunderstood the situation.

PCLinuxOS 32bit & 64bit; 3.2.17bfs kernel, KDE 4.8.3; nvidia 295.53, Athlon 64 X2 4200+; 4GB Ram; NVidia GeForce 8400GS 1GB; x.org 1.10.4 ; 500GB/320GB
Village Idiot
Hero Member
*****
Offline Offline

Posts: 2355


Have A Nice Day.


« Reply #5 on: May 18, 2010, 05:05:08 PM »

This wasn't a reference to PCLinuxOS in any way whatsoever.

No. Of course not.  Smiley

I was trying to bring the argument that I believe OSS documentation is better than alot of people realize.



Logged

$ fortune
No Microsoft products were used in any way for the creation of this message.
If you are using a Microsoft product to view it, BEWARE! - I'm not
responsible for any harm you might encounter as a result.
Pages: [1]   Go Up
  Print  
 
Jump to:  

Powered by MySQL Powered by PHP Powered by SMF 1.1.16 | SMF © 2011, Simple Machines

Valid XHTML 1.0! Valid CSS! Dilber MC Theme by HarzeM