Inline Documentation Standard for Filters
|Reported by:||CharlesClarkson||Owned by:|
I was hoping to get some insight on how to document filters as they are applied in a function. I'm referring to the use of the apply_filter() function inside a WordPress function, not for the use of the add_filter() function.
I thought to use something like one of these, but wanted some input on whether either was complete enough.
* @uses apply_filters() for 'wp_admin_bar_class' providing 'WP_Admin_Bar' as the default class. * @note Adds the 'wp_admin_bar_class' filter to allow changing the default 'WP_Admin_Bar' class. * @link http://codex.wordpress.org/index.php?title=Plugin_API/Filter_Reference/wp_admin_bar_class
(Note: The link doesn't work yet. it is established from the Plugin API/Filter Reference)
I tend to look at inline docs as I use them (to update the codex and to research solutions) and that may not fit with other uses. I would rather not have to go back (too many times) because the my standard was useless to other users.
Change History (8)
comment:7 @DrewAPicture — 2 years ago
- Milestone changed from Awaiting Review to 3.7
- Resolution set to fixed
- Severity changed from trivial to normal
- Status changed from new to closed