On Sunday, September 9, 2001, at 05:45 PM, Zeev Suraski wrote:
> At 00:26 10-09-01, Wez Furlong wrote:
>> Zeev Suraski [mailto:[EMAIL PROTECTED]] wrote:
>> > At 14:44 09-09-01, Jani Taskinen wrote:
>> > > If ZE was properly documented, people didn't have to rely on
>> > > only the sources.
>> > By the way, your post had absolutely nothing to do with the
>> > subject of the discussion.
>>
>> I think it does; if there were some official docs we could
>> then publish those guidelines that Andi was talking about,
>> and wouldn't have such a risk of people abusing the API.
>
> The reason I told Jani it had nothing to do with the discussion was
> that I think that this is wrong...
> The reason I disagree is that a large number of people (today, probably
> most) code based on examples, not on documentation. Nothing forces you
> to read the documentation.
Not writing documentation is certainly within your right, but this is a
poor argument for not doing so. Certainly a main reason that people
code from examples and not documentation is when documentation is poor.
--
PHP Development Mailing List <http://www.php.net/>
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
To contact the list administrators, e-mail: [EMAIL PROTECTED]
