Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add the other dev phase dates to Status of Python versions #998

Open
CAM-Gerlach opened this issue Dec 6, 2022 · 1 comment
Open

Add the other dev phase dates to Status of Python versions #998

CAM-Gerlach opened this issue Dec 6, 2022 · 1 comment
Assignees
Labels
enhancement guide-automation Automation and tooling for devguide guide-new content Additions; New content or section needed topic-versions

Comments

@CAM-Gerlach
Copy link
Member

CAM-Gerlach commented Dec 6, 2022

As [discussed] on PR #988 and at the Python Docs Community meeting, the Status of Python versions table is missing an indication of the expected/actual cut-over point between bugfix and security-only releases, which is fairly important information in line with the other dates displayed there. This is standard for most pages like this, and the Wikipedia page has it.

Additionally, it would seem to be quite helpful, especially since this is the CPython developer guide, to also add the dates for the dev cycle start, alpha, beta and rc phases, to make it easier for devs to quickly check the current phase and when the next one starts.

We should, at least, add additional JSON fields with this information. Since unfortunately with Mermaid it doesn't seem possible to add multiple segments to the same line, and it would clutter the main chart and table to add all these dates, I suggest we output these dates to a separate chart and table in a "Development Status" section, leaving the main one at the top. Eventually, it would seem ideal to migrate the main chart and table (or at least a simplified version) to the main Python,org site, since it is focused on user-facing information, while the proposed new section would contain developer-facing information

#999 is a followup, adding the individual point release version dates as JSON and subsidiary tables. These could be added to the chart in the development status section (and perhaps the latest release added to one of the main tables), or possibly the more detailed charts could be added/moved to the per-version subsections.

@CAM-Gerlach CAM-Gerlach self-assigned this Dec 6, 2022
@CAM-Gerlach CAM-Gerlach changed the title Add the bugfix -> security transition date to version status Add the other development phase dates to Status of Python versions Dec 6, 2022
@CAM-Gerlach CAM-Gerlach changed the title Add the other development phase dates to Status of Python versions Add the other dev phase dates to Status of Python versions Dec 6, 2022
@m-aciek
Copy link
Contributor

m-aciek commented Jul 20, 2023

Translation teams (and docs building team) are interested especially in first beta date as it used to be point of docs translations start for a release. Having the date would allow to base the automations on release-cycle.json file.

rffontenelle added a commit to rffontenelle/python-docs-tx-translations that referenced this issue Jul 23, 2023
@willingc willingc added guide-new content Additions; New content or section needed guide-automation Automation and tooling for devguide topic-versions enhancement and removed enhancement labels Oct 11, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
enhancement guide-automation Automation and tooling for devguide guide-new content Additions; New content or section needed topic-versions
Projects
None yet
Development

No branches or pull requests

4 participants
@willingc @m-aciek @CAM-Gerlach and others