django/djangoproject.com

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

Open

#2,094 opened on Jun 11, 2025

View on GitHub
 (11 comments) (0 reactions) (1 assignee)Python (2,001 stars) (1,100 forks)user submission
contentdocsgood first issue

Description

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
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
2
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
under 1 hour
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
blocked
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
clear
Prerequisites
Django template syntaxHTML
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
30
Research direction
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.
Add link to 'Stable' doc version in the Warning Alert on top · django/djangoproject.com#2094 | Good First Issue