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

[Peter Westwood]

/me trys again after gpg ate the previous email!.

On Mon, May 23, 2005 6:52 am, Martin Geisler said:
> Matthew Mullenweg <m at mullenweg.com> writes:
>
>> As much more core code will be touched it's likely that
>> compatibility with some things will be broken and there will need to
>> be a long testing period.
>
> I've only been using WordPress since February, but what has struck me
> as the biggest problem is the coding standard used.  I've written a
> longer piece[1] about it on my blog, but to summerize:
>
> * Global variables are used all over the place, making it difficult to
>   track the dependencies between various parts of the code.
>
> * 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.
>

Would a set of patches that added documentation in a format such as phpDocumentor [1] be welcome?

If so I'm quite willing to sit down and work on them as a way of giving back to the community

[1] - http://www.phpdoc.org/

westi
-- 
Peter Westwood
Blog: http://www.ftwr.co.uk/blog/
Get Firefox: http://www.spreadfirefox.com/?q=affiliates&id=20287