[wp-hackers] andrew hall - who why what & suggestion

[ayj & j]

who

Andrew Hall, my artists journal is at
http://www.andrew-hall-artist.com/journal/

why

I am interested in developing my scripting skills generally and in
particular in relation to WP and also in contributing to the development of
this great tool

what

We can save a lot of time by sharing our insights into the workings of WP.
That time can be applied to better productivity in development of WP and
it's capabilities. Makes sense to me.

Suggestion

I have a concrete suggestion regarding a pseudo documentation of WP for
people here.

I find the greatest constraint to efficiently creating something for WP - or
just helping someone else with their problem - is getting deeply familiar
with the underlying core WP code and structure. This might not be a problem
for the main WP developers but I am sure it is for many others who
nevertheless could make a useful contribution to WP.

Conversely, sometimes I spend a significant amount of time learning how one
part of the core code works and my understanding gained in doing that could
be useful to others. To give an minor example I recently spent a day getting
on top of how the basic upload.php page worked. I was surprised to find it
did not appear to be validating the file size limits at the server end and
it also seemed to have bugs in situations when the file size limit was
exceeded via the browser side checking.

The point here is not the specifics of my example. My suggestion is that we
create a facility for allowing us to leave detailed documentation and
commentary regarding each file of the WP core - and why not of all plug-ins
as well. Perhaps something along the lines of the on-line php manual. A
separate page for each file with posts underneath. Even better would be
links from the relevant point in the script to the comment.

Perhaps the wiki is meant to do this - I feel the wiki is also meant for a
wider audience who might not want the detail that I would myself find very
useful here.

Does this make sence to anyone else?

Andrew Hall