#5640 closed enhancement (fixed)
Inline Documentation for general-template.php
| Reported by: |
|
Owned by: |
|
|---|---|---|---|
| Priority: | low | Milestone: | 2.7 |
| Component: | Optimization | Version: | |
| Severity: | trivial | Keywords: | phpdoc has-patch commit |
| Cc: |
Description
PHPdoc effort seeks to complete phpdoc style inline documentation for wp-includes/general-template.php.
Needed to complete:
- Short and Long Descriptions.
- @since version info
- parameter type and description.
- return type and description.
Attachments (7)
Change History (20)
darkdragon — 5 years ago
comment:1
jacobsantos — 5 years ago
- Milestone changed from 2.9 to 2.7
comment:2
jacobsantos — 5 years ago
- Summary changed from PHPdoc effort for general-template.php to Inline Documentation for general-template.php
- Owner changed from anonymous to westi
- Status changed from new to assigned
Updating these now myself.
comment:5
jacobsantos — 5 years ago
Do you mean documenting the entire file, or do you mean just the patches? I'm working on the easy functions and will be submitting a patch. I don't think I've done any more general-template.php functions. The *-template.php functions are pretty easy now that I think about it, I can't figure why I haven't done them sooner.
That gets the file 80% complete.
Patches for the remaining functions and corrections of what I have already done welcome.
comment:9
jacobsantos — 5 years ago
- Keywords needs-patch added; has-patch removed
Corrections incoming tonight, going to seriously conflict with what I have now.
I use "Display" instead of "Outputs" or "Echos". I use "Retrieve" instead of "Returns".
Awesome so far!
comment:10
westi — 5 years ago
jacobsantos — 5 years ago
Completes with three functions left for inline documentation based off of r8852
comment:11
jacobsantos — 5 years ago
- Keywords has-patch commit added; needs-patch removed
Latest patch completes inline documentation.
comment:12
azaozz — 5 years ago
- Resolution set to fixed
- Status changed from assigned to closed
comment:14
jacobsantos — 3 years ago
The previous comment is spam.

Incomplete documentation for general-template.php based off of r6597