[wp-docs] Introduction and Proposal

[Malaiac]

2008/11/30 Jacob Santos <wordpress at santosj.name>:
> The way I envisioned it, was that the codex would link to the function
> documentation and extend it with examples. It took me a good year to
> complete the inline documentation with the source, so I hope that the time
> spent will prevent you from doing likewise. I also had selfish reasons for
> my involvement with the inline documentation and for it appears the same
> reasons you have for working on the codex.
>
> Good luck to you. Most people will want to use the codex before diving into
> the function documentation.

do we need documentation for tags AND functions ?

imho, only webmasters with some knowledge of php/mysql need to access
function documentation. The huge work made on inline doc *bows to
Jacob Santos* answers those questions.
"regular" users (webmasters who do not want to bother with php) only
use template tags and general documentation.

I'd vote with both hands to not maintain parallel documentations
(inline + codex) on functions.

Malaiac