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/

Reply via email to