[wp-meta] [Making WordPress.org] #1889: Inaccurate listings for @since tags
Making WordPress.org
noreply at wordpress.org
Mon Aug 15 17:42:43 UTC 2016
#1889: Inaccurate listings for @since tags
---------------------------+----------------------
Reporter: johnbillion | Owner:
Type: defect | Status: closed
Priority: normal | Milestone:
Component: Developer Hub | Resolution: invalid
Keywords: |
---------------------------+----------------------
Changes (by coffee2code):
* status: new => closed
* resolution: => invalid
Comment:
The 'since' view was never intended to list functions introduced in a
given release. It is meant to list functions added or updated in a given
release (that is to say, those that have a `@since` entry for that
release).
On the [https://developer.wordpress.org/reference/ code reference landing
page] that's why the widget is labeled "New and Updated in WordPress X.Y"
instead of just "New in...".
While the desire to find functions, etc introduced in a given WP release
is reasonable, it wasn't feasible for consideration until recently since
the `@since` tag wasn't always present for a reasonable majority of
functions. (I believe it was only through an effort within the last couple
of years that many functions saw an `@since` added for their introduction
to the codebase.)
Anyhow, the 'since' view has been this way for years so it's best not to
change what it represents. I'd advocate making a separate ticket to
request introduction of the ability to view functions, etc introduced in a
given release. It'd likely entail creating a new taxonomy. (`@since` is
its own taxonomy, but it'd be hairy to get only the posts that have a
`@since` for a given version but not any earlier version).
--
Ticket URL: <https://meta.trac.wordpress.org/ticket/1889#comment:2>
Making WordPress.org <https://meta.trac.wordpress.org/>
Making WordPress.org
More information about the wp-meta
mailing list