[issue38004] Duplicated sections in changelog
New submission from Inada Naoki <songofacandy@gmail.com>: See TOC in https://docs.python.org/3.7/whatsnew/changelog.html Some releases (*) have multiple "Library" and "Security" sections. (*) e.g. 3.6.0a3, 3.6.0a2, 3.6.0a1, 3.5.3rc1, 3.5.2rc1 ---------- assignee: docs@python components: Documentation messages: 350971 nosy: docs@python, inada.naoki priority: normal severity: normal status: open title: Duplicated sections in changelog versions: Python 3.7, Python 3.8, Python 3.9 _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue38004> _______________________________________
Change by Karthikeyan Singaravelan <tir.karthi@gmail.com>: ---------- nosy: +ned.deily _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue38004> _______________________________________
Ned Deily <nad@python.org> added the comment: I'm not sure what happened here or why we haven't noticed it before. For example, it appears that the consolidated blurb file for the earliest example, 3.5.2rc1.rst, has not been modified since its original blurbification (in b902833f35efa1053f75d7b37769b27cb39e2682) and the sections are not sorted and consolidated properly there, i.e. Security entries, then Library, then Security again, etc etc. I"m assuming blurb requires all entries for a section to be contiguous. If so, we'll need to reorder the entries in the affected .rst files perhaps with blurb's aid. Perhaps Larry has an insight on what the easiest approach might be to do that. After fixing the .rst files for the affected releases, it would be a good time to forward port the current versions to later release branches and master so that the changelogs produced in newer releases is complete for older releases (forward port Misc/NEWS.d entries from 3.4 -> 3.5 -> 3.6 -> ... -> master). ---------- nosy: +larry versions: +Python 3.5, Python 3.6 _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue38004> _______________________________________
Ned Deily <nad@python.org> added the comment: Ah, some further insight: I realized that the original docset for 3.5.2 is available in the documentation archive. Comparing the (pre-blurb) changelog from the original release to its current state: https://docs.python.org/release/3.5.2/whatsnew/changelog.html#python-3-5-2-r... https://docs.python.org/3.5/whatsnew/changelog.html#python-3-5-2-release-can... It looks like the issues are in the same order in both but some issues were reclassified from Library to Security or from Misc to Windows, for example, (during blurbification I imagine) and that seems to explain the non-contiguous sections. ---------- _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue38004> _______________________________________
participants (3)
-
Inada Naoki -
Karthikeyan Singaravelan
-
Ned Deily