[wp-trac] [WordPress Trac] #29876: Document default arguments for WP_Meta_Query
WordPress Trac
noreply at wordpress.org
Tue Oct 7 02:07:18 UTC 2014
#29876: Document default arguments for WP_Meta_Query
--------------------------------+----------------------------------------
Reporter: DrewAPicture | Owner:
Type: defect (bug) | Status: new
Priority: normal | Milestone: Awaiting Review
Component: Options, Meta APIs | Version:
Severity: normal | Keywords: good-first-bug needs-patch
Focuses: docs |
--------------------------------+----------------------------------------
The default arguments for
[https://developer.wordpress.org/reference/classes/wp_meta_query/
WP_Meta_Query] need to be documented in the
[https://make.wordpress.org/core/handbook/inline-documentation-standards
/php-documentation-standards/#1-1-parameters-that-are-arrays hash
notation] style. The actual docs would go into the docblock for
`WP_Meta_Query::__construct()`.
Here are a couple of good example of documenting default arguments in hash
notations:
* [https://core.trac.wordpress.org/browser/trunk/src/wp-
includes/user.php#L496 docs] for `WP_User_Query::prepare_query()`
* [https://core.trac.wordpress.org/browser/trunk/src/wp-
includes/query.php#L1446 docs] for `WP_Query::parse_query()`
If it helps, you can use the `WP_Meta_Query`
[http://codex.wordpress.org/Class_Reference/WP_Meta_Query Codex article]
to find more information on the default arguments.
This ticket is reserved for new contributors on the good-first-bug
keyword.
--
Ticket URL: <https://core.trac.wordpress.org/ticket/29876>
WordPress Trac <https://core.trac.wordpress.org/>
WordPress publishing platform
More information about the wp-trac
mailing list