[opencms-dev] Heip

[Paul D. Bain]

Patrick Donker wrote:
>>
>> -----Original Message-----
>> From: opencms-dev-bounces at opencms.org
>> [mailto:opencms-dev-bounces at opencms.org] On Behalf Of Patrick Donker
>> Sent: Monday, May 23, 2005 1:52 AM
>> To: The OpenCms mailing list
>> Subject: Re: [opencms-dev] Heip
>>
>> Paul D. Bain wrote:
>>
>>  
>>
>>> Jim Romano wrote:
>>>
>>>   
>>>
>>>> I am using the lates version of Opencms but can not seem to find the 
>>>> documentation. In the older version it was clearly defined as 
>>>> "alkacon-documentation" right in sites/default.
>>>>
>>>> Please advise as to where documentation is in 6.0 beta 3
>>>>
>>>>     
>>>
>>> Jim,
>>>
>>>    Perhaps Alkacon and the other OpenCms developers have not had time 
>>> to write documentation for version 6.
>>>
>>> --Paul Bain
>>>   
>>
>>
>> Please dont consider this a flame, but isnt this typical oss 
>> behaviour? I never have understand why this is common practice in oss 
>> land. Ok, it is free, but if oss realy wants to become a serious 
>> competitor for commercial software, I think that writing manuals is a 
>> necessity. We are encouraged to use 6, but we're not told how...
>>
>> -Patrick

Patrick,

	First, I have seen the documentation of _many_ OSS projects, and, in 
comparison to most of them, the documentation for OC is, without 
question, among the best. I do not know of any other OSS project that 
has better documentation. That is not to say, of course, that the 
documentation could not be improved. There are still too many "features" 
in OC that are not documented.

	Second, there are at least two reasons as to why "this is common 
practice in OSS land." Most software developers prefer to write code 
rather than write documentation, and OSS developers tend to regard their 
code itself as documentation -- if you need to know how the software 
works, you can simply read the source code. Many users of OC seem to do 
precisely that.

	Third, OSS is already "a serious competitor" to proprietary software. 
Hell, Linux is clobbering both Solaris and MS Windows. If current trends 
continue, Solaris will be _gone_ in just a few years, as will all of the 
other proprietary versions of Unix.

--Paul Bain

>>> Vasil Stefanov wrote:
>>>
>>> I can't understand what you mean, but there is documentation for 
>>> OpenCMS 6b3
>>> and this documentation is exactly in sites/default and is named
>>> "alkacon-documentation" !
>>>
> I know. My remark was about oss in general
> And thanks for top posting....
> 
> 
> _______________________________________________
> This mail is send to you from the opencms-dev mailing list
> To change your list options, or to unsubscribe from the list, please visit
> http://mail.opencms.org/mailman/listinfo/opencms-dev
>