Document ``next`` in versionadded & similar directives by encukou · Pull Request #1413 · python/devguide
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
It would be better to just decide which versions next should be backported to, backport it, and then list those versions here.
Can you also clarify when would backporting be necessary for a versionadded? New features should be documented on the next release, and not backported to previous versions.
The only exception I can think of is if we are documenting an addition after the fact, but this is covered in the next paragraph.
versionchanged are more likely to be backported, so maybe this paragraph should be moved there.