[wp-docs] Preemptively marking deprecated functions?

Chip Bennett chip at chipbennett.net
Wed Apr 18 22:59:45 UTC 2012


Wouldn't it be helpful if those Deprecation notices listed the version in
which the function was deprecated? That would eliminate the confusion AND
provide useful information.

Chip

On Wed, Apr 18, 2012 at 5:45 PM, Kailey Lampert <trepmal at gmail.com> wrote:

> Thanks,
> I've added the clarification. Hopefully it will prevent people from making
> the same mistake I did. Twice.
>
> Kailey Lampert
> twitter: @trepmal
> trepmal at gmail.com
>
>
>
> On Wed, Apr 18, 2012 at 2:19 PM, Michael Hancock <justmichaelh at gmail.com>wrote:
>
>> ** **
>>
>> ** **
>>
>> Kailey Lampert>>>>
>> There are 2 functions that I know of that have already been marked as
>> deprecated, even though that won't actually happen until the release of 3.4
>> ****
>>
>> ** **
>>
>> http://codex.wordpress.org/Function_Reference/add_custom_background****
>>
>> http://codex.wordpress.org/Function_Reference/add_custom_image_header****
>>
>> ** **
>>
>> Similarly, the page for add_theme_support() implies it's ready to replace
>> those 2 functions****
>>
>> http://codex.wordpress.org/Function_Reference/add_theme_support****
>>
>> ** **
>>
>> It's not until you look at the change log at the bottom of those pages
>> that you can see that some of this will only be applicable in the next
>> release.****
>>
>> ** **
>>
>> I wanted to add some clarification on those pages, but I wanted to check
>> and see if there were already rules/guidelines in place for this.****
>>
>> <<<<** **
>>
>> ** **
>>
>> No real guidelines, that I know of, but if you want, put a note at the
>> top of the page that the articles are in transition to meet 3.4 core.
>> Please remember to remove that after 3.4 comes out next month.****
>>
>> ** **
>>
>> Thanks.****
>>
>> ** **
>>
>> MichaelH****
>>
>> ** **
>>
>>
>> ****
>>
>> ** **
>>
>> _______________________________________________
>> wp-docs mailing list
>> wp-docs at lists.automattic.com
>> http://lists.automattic.com/mailman/listinfo/wp-docs
>>
>>
>
> _______________________________________________
> wp-docs mailing list
> wp-docs at lists.automattic.com
> http://lists.automattic.com/mailman/listinfo/wp-docs
>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.automattic.com/pipermail/wp-docs/attachments/20120418/6744a1ee/attachment.htm>


More information about the wp-docs mailing list