[wp-docs] Function Reference a Mess

[Michael Fields]

I would agree that the page looks horrible.
All the info is crammed together & definitions are sparse.
I think that it would be a great idea to add a two column layout w/ 
definition, or maybe even a one column layout like php.net does: 
http://us2.php.net/manual/en/ref.array.php

Another thing that came to mind while looking at the Function Reference 
page, was that some functions have braces which contain the accepted 
parameters. This is also inconsistent. Some functions even have the type 
of parameter see: 'wp_update_post( $postarr=array() )'...

And added note: Might it be useful to include a link to a function cross 
reference on this page for advanced users?

I don't know the policies to well as I am new to this list - Just wanted 
to throw in my opinions.

My name is Mike by the way.

And I love WordPress!!!

And am willing to help out.

-Mike






Lorelle VanFossen wrote:
> http://codex.wordpress.org/Function_Reference/ is a mess.
>
> The Function Reference should match, in look and style, the Template 
> Tags page. The Template Tags master directory page is set up with the 
> template tags listed under each "category" of use. So the Function 
> Reference page started out.
>
> People have now been attempting to add a "definition" of the functions 
> into the list and it looks horrible.
>
> If we recreate the list to display functions and definition, it must 
> be consistent and available for EVERY function - and then the same 
> technique applied to the Template Tags page.
>
> So the question is, do we stick to the format set in the  Template 
> Tags or redefine both with function/tag and definitions (a two column 
> layout for every section)?
>
> Lorelle
>
> ------------------------------------------------------------------------
>
> _______________________________________________
> wp-docs mailing list
> wp-docs at lists.automattic.com
> http://lists.automattic.com/mailman/listinfo/wp-docs
>