[wp-hackers] Re: 1.5.2 or on to 1.6?

[Jeff Minard]

Martin Geisler wrote:
> * There are no comments in vast parts of the core code.  To understand
>   the core functions one has to read the body of the functions, which
>   is really bad, IMHO.  Doccomments which specify argument and return
>   types would be a very good move.

Additionally, when well commented there are scripts that will create 
function refs automatically. That'd be pretty sweet.

Jeff