Opened 18 years ago
Closed 17 years ago
#4742 closed defect (bug) (fixed)
phpdoc for taxonomy API
Reported by: |
|
Owned by: | |
---|---|---|---|
Milestone: | 2.5 | Priority: | normal |
Severity: | normal | Version: | 2.3 |
Component: | Administration | Keywords: | taxonomy phpdoc has-patch developer-feedback |
Focuses: | Cc: |
Description
The new taxonomy API needs phpdoc. A few of the functions in wp-includes/taxonomy.php have the beginnings of some phpdoc, but they need to be updated and extended.
Attachments (6)
Change History (24)
@
18 years ago
Completed more phpDoc for functions. Fixed some previous descriptions, and added blank descriptions with params and return completed to other functions.
#5
@
18 years ago
Holy crap, you'll find that some functions that short and long descriptions in between others which don't. If the function was easy enough to decipher, I went ahead and filled out the information.
I figure it is easier to complete the param and return information first and then go back when the information is more clear.
Note: I place some extra non-phpdoc tags for some of the filters. Given that non-phpDoc tags won't show up and that the rest of the information is in a @internal tag, I would assume that it won't adversely affect the output. It would allow for a custom plugin or solution to take the tag (if written in PHP5 (be easier at least) ) and output all of the filter and actions information without having to do a search for add_action of add_filter functions. Just thought it might be useful.
#6
@
18 years ago
- Keywords developer-feedback added
Part of this ticket was commited. Do we commit the rest for 2.3 as well or close this one and open a new ticket for 2.4?
#8
@
18 years ago
I applied the the second patch. Since I took so long, some parts didn't apply due to conflicts. We can keep working on phpdoc for taxonomy for 2.3 up through the RC on Sep. 17th if anyone is interested.
#9
@
18 years ago
Well, I do things mostly in stages. Once I realized just how many functions there were and how difficult some of the functions will be to describe I switched over to documenting the parameters, return values, and template the short description and long descriptions for later.
I think at some point, the original developer should go over what I wrote and confirm or correct what I wrote.
#10
@
18 years ago
Added a patch that almost completely covers the parameters and return values. Missing mostly cache functions.
This patch still doesn't completely cover the short and long descriptions for most of the functions. If anyone wants to help out with that, be my guess. I figure that at least the parameters and return types might be useful at this point of time.
@
18 years ago
Added @since tags to all functions, cleaned up and correct documentation, as well as added some documentation to functions. Still Incomplete.
#13
@
18 years ago
Goodness, Well on the way to getting there. It always happens that I document this file whenever I'm just about ready to go to bed. I hope the documentation doesn't suffer because of it.
More this weekend I suspect.
@
18 years ago
Patched against r6291 and cleans up and brings the total needing documentation to four
Know of any good phpdoc how-to's ? It may be that a little education is what we need to accelerate phpdoc rollout.