[issue26755] Update version{added,changed} docs in devguide

[Berker Peksag]

Changes by Berker Peksag :


--
resolution:  -> fixed
stage: patch review -> resolved
status: open -> closed

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue26755] Update version{added,changed} docs in devguide

[Roundup Robot]

Roundup Robot added the comment:

New changeset 6ef3d77b3c27 by Berker Peksag in branch 'default':
Issue #26755: Clarify when version{added,changed} directives should be used in 
docs
https://hg.python.org/devguide/rev/6ef3d77b3c27

--
nosy: +python-dev

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue26755] Update version{added,changed} docs in devguide

[Georg Brandl]

Georg Brandl added the comment:

Now that "added" doesn't mention the second argument, the "This one *must* have 
the second argument (explanation of the change)." should be changed. Otherwise 
+1.

--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue26755] Update version{added,changed} docs in devguide

[Berker Peksag]

New submission from Berker Peksag:

This is a follow-up from issue 26366:

"the original intention was to use "versionadded" where the API item is 
completely new.  So "The parameter x was added" in a function is using 
"versionchanged" because only an aspect of the function's signature was 
changed."

See msg260314 and msg260509 for details.

--
components: Devguide
files: versionchanged.diff
keywords: patch
messages: 263393
nosy: berker.peksag, ezio.melotti, georg.brandl, willingc
priority: normal
severity: normal
stage: patch review
status: open
title: Update version{added,changed} docs in devguide
type: behavior
Added file: http://bugs.python.org/file42461/versionchanged.diff

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com