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
[email protected]
http://lists.automattic.com/mailman/listinfo/wp-docs

_______________________________________________
wp-docs mailing list
[email protected]
http://lists.automattic.com/mailman/listinfo/wp-docs

Reply via email to