Skip to content

Security branches: Consider fixing the documentation or adding a notice banner #120795

@e-gebes

Description

@e-gebes

Documentation

For issue #90562, which is not yet fixed, the documentation has been updated to mention the issue for 3.12 and 3.13, but a request to backport it further to 3.10 was replied with a link https://devguide.python.org/versions/ that only security fixes are allowed for 3.10.

Since 3.10 and all security branch releases are obviously expected to be used, it makes sense to be able to expect the documentation can be relied on as well. End-of-life versions like 3.7 have a red banner at the top of each documentation page:

This document is for an old version of Python that is no longer supported. You should upgrade, and read the Python documentation for the current stable release.

It's clear to the reader that also the doc pages are not maintained and might be outdated.

I suggest to consider either

or

  • Add a yellow banner notice on top of each documentation page for security branch releases, making it clear that the documentation is not maintained anymore. (In style similar to the red banner for end-of-life releases.)

Metadata

Metadata

Assignees

No one assigned

    Labels

    docsDocumentation in the Doc dir

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions

      pFad - Phonifier reborn

      Pfad - The Proxy pFad of © 2024 Garber Painting. All rights reserved.

      Note: This service is not intended for secure transactions such as banking, social media, email, or purchasing. Use at your own risk. We assume no liability whatsoever for broken pages.


      Alternative Proxies:

      Alternative Proxy

      pFad Proxy

      pFad v3 Proxy

      pFad v4 Proxy