Assuming the release managers are on-board with the idea (since it would impact them the most), I'm +1. Overall, it seems like it would help significantly to reduce the total number of different locations to update during the release process once we get it fully configured.
> It could become more detailed about each minor versions, git tag, links to changelogs, links to the repositories, to the docs, download links, and so on. I don't know that it needs to be said, but for now, I think we should start with a minimalist approach by keeping the API focused on reducing the number of *existing* locations to update, rather than predicting what might sort of fields might be useful to include. Otherwise, it could very well end up becoming more work to maintain compared to what it actually saves. On Tue, May 26, 2020 at 6:38 PM Julien Palard via Python-ideas < python-ideas@python.org> wrote: > We do not have a standard way to get (programatically) informations > about Python versions, this leads to having to commit to numerous places > during each releases, and some other places never get the information > (like old docs, see [1]). > > > Maybe we should provide an HTTP API listing Python versions, like: > > { > "current_stable": "3.8.3", > "versions": [ > { > "branch": "master", > "status": "dev", > "version": "3.10", > "release_manager": "Łukasz Langa", > "doc_languages": ["en", "es", "fr", "ja", "ko", "pt-br", > "zh-cn"] > }, > { > "branch": "3.9", > "latest": "3.9.0b1", > "status": "features", > "pep": 596, > "version": "3.9", > "release_manager": "Łukasz Langa", > "doc_languages": ["en", "fr", "ja", "ko", "pt-br", "zh-cn"] > }, > { > "branch": "3.8", > "latest": "3.8.3", > "status": "bugfix", > "pep": 569, > "version": "3.8", > "release_manager": "Łukasz Langa", > "first_release": "2019-10-14", > "end_life": "2024-10", > "doc_languages": ["en", "fr", "ja", "ko", "pt-br", "zh-cn"] > }, > { > "branch": "3.7", > "latest": "3.7.7", > "status": "bugfix", > "pep": 537, > "version": "3.8", > "release_manager": "Ned Deily", > "first_release": "2018-06-27", > "end_life": "2023-06-27", > "doc_languages": ["en", "fr", "ja", "ko", "pt-br"] > } > ... > > (Don't really mind this particular example, it's a random first though, > the doc_languages should probably be a dict instead, with links to the > actual docs, ...) > > It could be used to (and maybe avoid a commit) to: > - build the documentation version switcher and languages switchers > - toggle the red deprecated banner (to be seen on [2] if you missed it) > - generate the versions table at https://devguide.python.org/ > - generate the Docs by version menu > - generate the Download menu and download page of python.org > - list the documentations versions to be built by docsbuild-script > - probably many scripts could use it too, I can think of [3] > - ... > > It could become more detailed about each minor versions, git tag, links > to changelogs, links to the repositories, to the docs, download links, > and so on. > > Maybe this idea will just add a commit to do between the numerous > commits to already do during a release... (à la https://xkcd.com/927/), > and a SPOF. > > What do you think? > > [1]: > > https://mail.python.org/archives/list/d...@python.org/thread/L724YZXXHQZQP4HJYXCDCLYLBJB726D3/ > [2]: https://docs.python.org/2.7/ > [3]: https://gitlab.com/python-devs/ci-images/-/blob/master/Dockerfile#L19 > > -- > [Julien Palard](https://mdk.fr) > _______________________________________________ > Python-ideas mailing list -- python-ideas@python.org > To unsubscribe send an email to python-ideas-le...@python.org > https://mail.python.org/mailman3/lists/python-ideas.python.org/ > Message archived at > https://mail.python.org/archives/list/python-ideas@python.org/message/Y35KK55BW7PTUIQKSNROLZGYVHBMHE7O/ > Code of Conduct: http://python.org/psf/codeofconduct/ >
_______________________________________________ Python-ideas mailing list -- python-ideas@python.org To unsubscribe send an email to python-ideas-le...@python.org https://mail.python.org/mailman3/lists/python-ideas.python.org/ Message archived at https://mail.python.org/archives/list/python-ideas@python.org/message/4PVCVYI6U7OIFQNBOPK4HUCF2NZS6WLN/ Code of Conduct: http://python.org/psf/codeofconduct/