Document PendingDeprecationWarning is not so useful.

[methane]

BPO	36404
Nosy	@brettcannon, @methane, @miss-islington
PRs	bpo-36404: recommend DeprecationWarning over PendingDeprecationWarning #12505 [3.7] bpo-36404: recommend DeprecationWarning over PendingDeprecationWarning (GH-12505) #12696 bpo-36404: update PendingDeprecationWarning explanation #12837 [3.7] bpo-36404: update PendingDeprecationWarning explanation (GH-12837) #12838

^{Note: these values reflect the state of the issue at the time it was migrated and might not reflect the current state.}

Show more details

GitHub fields:

assignee = None
closed_at = <Date 2019-04-05.08:55:51.652>
created_at = <Date 2019-03-23.02:05:05.216>
labels = ['3.8', 'docs']
title = 'Document PendingDeprecationWarning is not so useful.'
updated_at = <Date 2019-04-15.12:41:38.513>
user = 'https://github.com/methane'

bugs.python.org fields:

activity = <Date 2019-04-15.12:41:38.513>
actor = 'miss-islington'
assignee = 'docs@python'
closed = True
closed_date = <Date 2019-04-05.08:55:51.652>
closer = 'methane'
components = ['Documentation']
creation = <Date 2019-03-23.02:05:05.216>
creator = 'methane'
dependencies = []
files = []
hgrepos = []
issue_num = 36404
keywords = ['patch']
message_count = 3.0
messages = ['339478', '339479', '339482']
nosy_count = 4.0
nosy_names = ['brett.cannon', 'methane', 'docs@python', 'miss-islington']
pr_nums = ['12505', '12696', '12837', '12838']
priority = 'normal'
resolution = 'fixed'
stage = 'resolved'
status = 'closed'
superseder = None
type = None
url = 'https://bugs.python.org/issue36404'
versions = ['Python 3.8']

[methane]

New changeset 176d263 by Inada Naoki in branch 'master':
bpo-36404: recommend DeprecationWarning over PendingDeprecationWarning (GH-12505)
176d263

[methane]

After discussion on ML, I just recommend DeprecationWarning
over PendingDeprecationWarning in this time.
PendingDeprecationWarning is not deprecated for now.

[miss-islington]

New changeset 86fbe02 by Miss Islington (bot) in branch '3.7':
bpo-36404: recommend DeprecationWarning over PendingDeprecationWarning (GH-12505)
86fbe02