WP-Admin File Level Inline Documentation for 2.7

[santosj]

Patches for adding file level inline documentation to wp-admin files.

[santosj]

File level inline documentation for some of wp-admin files based off of r8616.

[santosj]

There are a lot of files in wp-admin/ directory. I'm going to complete them in sets of files, once I understand what most of them are. Might be able to use the codex for most of the files.

[ryan]

(In [8618]) WP-Admin File Level Inline Documentation from santosj. see #7496

[santosj]

More file level and other phpdoc for wp-admin directory based off of r8623

[santosj]

More file and function level inline documentation for wp-admin files, based off of r8636

[santosj]

More file level and other phpdoc for wp-admin directory based off of r8640

[santosj]

Latest patch 7496.phpdoc.r8640.patch includes file level inline documentation for the WordPress Importers. The patch is starting to get large. Is there a problem that I need to resolve with the patch in order to get it in?

[westi]

That is large.

I will have a look at get it in.

[westi]

(In [8645]) phpdoc for wp-admin. See #7496 props santosj.

[jacobsantos]

Would you rather me have smaller patches?

I realize that you have to review the patches for consistency, accuracy, and to make sure things don't go "boom!" There is a but, but I'm not sure what I'm trying to say.

[jacobsantos]

Thanks.

[santosj]

Finishes the file level inline documentation for wp-admin/*.php. Need to finish wp-admin/includes/*.php files. Based off of r8653

[santosj]

What is wp-admin/sidebar.php used for? It appears to be a write post page, and that is all. Was it the previous bookmarklet before Press This? It is the only file that needs file level documentation, but I'm not going to do anything with it, until I know for sure what it is.

The focus is now going to turn to wp-admin/includes/*.php, which will be in separate tickets.

[westi]

(In [8656]) More phpdoc updates for wp-adming. See #7496 props santosj.

[jacobsantos]

wp-admin/sidebar.php file level inline documentation completes ticket based off of r8656

[jacobsantos]

From base WordPress, completes wp-admin file level inline documentation based off of r8656

[ryan]

(In [8674]) File level phpdoc from santosj. fixes #7496