[wp-hackers] Inline Documentation Effort was a Failure

[Jason Webster]

http://www.phpdoc.org/


Jorge Peña wrote:
> I'm with Matt here, but of course my say is nothing because I'm not as
> experienced as you guys. It just seems more logical to have it some place
> else. Or maybe the inline docs can be parsed and generated into an external
> doc? As is the case with some documentation programs, maybe there's
> something like this for PHP? I'm pretty sure there is, I'm just not as
> experienced, like I said.
>
> On Wed, May 28, 2008 at 6:18 PM, Matt <speedboxer at gmail.com> wrote:
>
>   
>> On Wed, May 28, 2008 at 5:54 AM, Jacob Santos <wordpress at santosj.name>
>> wrote:
>>     
>>> What I think you are wrong then, is that you aren't weighing the
>>>       
>> importance
>>     
>>> of documentation compared to the small gain of its removal?
>>>       
>> I never said that. Documentation is helpful, but (probably going to
>> start up some sort of flame war here :P ) wouldn't it be better if it
>> was located in some sort of Developer-only docs (separate from the
>> Codex, which would be end-user-oriented), rather than in the code? The
>> just put a link to the docs in a comment above the function.
>>
>> --
>> Matt (speedboxer at gmail.com)
>> http://mattsblog.ca/
>> _______________________________________________
>> wp-hackers mailing list
>> wp-hackers at lists.automattic.com
>> http://lists.automattic.com/mailman/listinfo/wp-hackers
>>
>>     
> _______________________________________________
> wp-hackers mailing list
> wp-hackers at lists.automattic.com
> http://lists.automattic.com/mailman/listinfo/wp-hackers
>