[wp-docs] PHPDoc and state of the Codex

[Steve]

I think that the template tags should be updated more often, yes, but I
think the current system would probably be the best for how they are laid
out. My reasoning is based on the assumption that PHPdocs would generate the
basic technical information about each tag, but not really explain it in
paragraph form for the less experienced user (like the php.net manual vs the
w3schools tutorials). Because of this, and because of the inherent
user-friendliness of the template tags, I think that section should continue
to be added to by real people who can take the time to explain the
functions.

But as for the (more advanced) function reference section, I'd like to see
that be automatically generated by PHPdocs.

That's my 0.02624 euros worth

-Steve

On Tue, Oct 21, 2008 at 3:08 PM, Lorelle on WordPress <
lorelleonwordpress at gmail.com> wrote:

> Thanks for doing this. I've been watching this and wondering when it was
> ready for the Codex. Is it ready? I'm excited about connecting these dots
> better in the Codex. Thanks for staying on this, Jennifer!
>
> Lorelle
>
> _______________________________________________
> wp-docs mailing list
> wp-docs at lists.automattic.com
> http://lists.automattic.com/mailman/listinfo/wp-docs
>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://comox.textdrive.com/pipermail/wp-docs/attachments/20081021/f33cc5bb/attachment.htm