[wp-hackers] Inline Documentation Effort was a Failure

[Jorge Peña]

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
>