Improve documentation for add_*_page

[westi]

We need some php doc for the menu functions and some argument renaming so as to hilight best practise and how we recommend the functions are used.

We also need to hilight that functions should check the capability as well and we ask for it to enforce visibility.

[westi]

(In [12914]) Add phpdoc to all the add_*_page functions.
Rename arguments to empasise that people should be using Capabilities not User Levels and named hooks not FILE.
See #12101.

[westi]

That improves things quite a bit.

We still need to review the codex to ensure it recommends best practise too.

[markmcwilliams]

Replying to westi:

That improves things quite a bit.

We still need to review the codex to ensure it recommends best practise too.

Sure does, I just had a quick read through and got to say I understand those functions a lot more now, but I have never needed to think about thses functions, so I'm not sure if the codex is upto scratch or not? :)

[nacin]

Resolving as fixed. This will stay in the new "Needs Codex Work" report even after closure. Once handled there, the keyword can be removed so it drops from the report.

[michaelh]

A little dicey knowing if the "function" parameter explanations, for both add_menu_page and add_submenu_page, are correct, but will remove the needs-codex tag for now.

​http://codex.wordpress.org/Adding_Administration_Menus

[westi]

Looks good to me.

Thanks Michael!