Doc/whatsnew/* v. Misc/NEWS
Do we really need both Doc/whatsnew/* and Misc/NEWS? It seems that people frequently make nearly the same edits to both files, or add to Misc/NEWS only and someone later (usually Andrew) goes back and twiddles the necessary bits in Doc/whatsnew. Skip
Skip Montanaro wrote:
Do we really need both Doc/whatsnew/* and Misc/NEWS?
Yes, we do. Misc/NEWS is complete, listing everything that's changed since the previous version. whatsnew is friendly, and there's a cutoff point; some changes are too trivial or esoteric to be worth mentioning. Feel free to only edit Misc/NEWS; before releases I'll go through it to find things I've missed, so there's no need to update whatsnew23.tex. I don't mind if people edit whatsnew23.tex to add items, but it's certainly not necessary. --amk
Feel free to only edit Misc/NEWS; before releases I'll go through it to find things I've missed, so there's no need to update whatsnew23.tex. I don't mind if people edit whatsnew23.tex to add items, but it's certainly not necessary.
Thanks for mentioning that. I was really wondering about what to do. -- Gustavo Niemeyer [ 2AAC 7928 0FBF 0299 5EB5 60E2 2253 B29A 6664 3A0C ]
Feel free to only edit Misc/NEWS; before releases I'll go through it to find things I've missed, so there's no need to update whatsnew23.tex. I don't mind if people edit whatsnew23.tex to add items, but it's certainly not necessary.
Thanks for mentioning that. I was really wondering about what to do.
Someone should add this to the developer guidelines on python.org/dev/ --Guido van Rossum (home page: http://www.python.org/~guido/)
[amk]
Feel free to only edit Misc/NEWS; before releases I'll go through it to find things I've missed, so there's no need to update whatsnew23.tex. I don't mind if people edit whatsnew23.tex to add items, but it's certainly not necessary.
[gustavo]
Thanks for mentioning that. I was really wondering about what to do. [guido]
Someone should add this to the developer guidelines on python.org/dev/
I added a couple of paragraphs under "Recording Change" in http://www.python.org/dev/process.html I hope they'll serve. Better than nothing, anyhway. regards ----------------------------------------------------------------------- Steve Holden http://www.holdenweb.com/ Python Web Programming http://pydish.holdenweb.com/pwp/ Previous .sig file retired to www.homeforoldsigs.com -----------------------------------------------------------------------
Do we really need both Doc/whatsnew/* and Misc/NEWS? It seems that people frequently make nearly the same edits to both files, or add to Misc/NEWS only and someone later (usually Andrew) goes back and twiddles the necessary bits in Doc/whatsnew.
They serve different purposes. Misc/NEWS is supposed to be exhaustive, but terse. whatsnew23.tex is supposed to give the highlights, with examples, etc. --Guido van Rossum (home page: http://www.python.org/~guido/)
participants (5)
-
A.M. Kuchling -
Guido van Rossum -
Gustavo Niemeyer -
Skip Montanaro -
Steve Holden