django/djangoproject.com

Add link to 'Stable' doc version in the Warning Alert on top

Open

#2.094 geöffnet am 11. Juni 2025

Auf GitHub ansehen
 (11 Kommentare) (0 Reaktionen) (1 zugewiesene Person)Python (2.001 Stars) (1.100 Forks)user submission
contentdocsgood first issue

Beschreibung

As discussed on discord in #documentation channel here

I think this will provide 'further convenience' to website users to upgrade the documentation version by simply clicking on the link in the warning itself as well:

Current Behavior of the Warning Alert on Top:

Image

Proposed change (text can be adjusted accordingly):

Image

Rationale:

  • The warning alert already exists, and draws eye attention towards itself (due to its bright color)
  • Adding a clickable link is 'further convenience' in terms of UX
  • Requires small change in code

Contributor Guide

Tech Stack
pythonhtmlcss
Domain
frontenddocumentation
Issue Type
feature
SchwierigkeitGeschätzte Implementierungsschwierigkeit für neue Contributors, von 1 für sehr kleine Änderungen bis 5 für Expertenarbeit.
2
Geschätzte ZeitEin grober Zeitrahmen, um zu recherchieren, zu implementieren, zu testen und einen Pull Request vorzubereiten.
under 1 hour
AktivitätsstatusWie verfügbar das Issue gerade wirkt: frisch, aktiv, stale, blockiert oder wartet auf Maintainer-Input.
blocked
KlarheitWie klar das Issue die erwartete Änderung, Akzeptanzkriterien und den nächsten Schritt erklärt.
clear
Voraussetzungen
Django template syntaxHTML
EinsteigerfreundlichkeitEin Score von 1 bis 100, der schätzt, wie zugänglich dieses Issue für First-Time Contributors ist.
30
Research-Richtung
Locate the template file that renders the warning alert on documentation pages (likely in the docs templates directory). Add a hyperlink to the 'Stable' version of the docs within the alert message, using Django's URL template tag. Verify the change by running the local development server and checking the alert display. Reference the Discord thread for exact wording of the link text.