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 (1,100 forks)user submission
contentdocsgood first issue

Repository metrics

Stars
 (2,001 stars)
PR merge metrics
 (Avg merge 7d 6h) (16 merged PRs in 30d)

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

Research direction
Find the template file containing the warning alert for documentation versions and add a hyperlink to the stable version. The template is likely in the 'docs' or 'templates' directory. Look for a warning banner with version text and modify it to include an anchor tag linking to the stable docs URL.
Tech stack
htmlcsspython
Domain
frontend
Issue type
Feature
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
1
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
1-3 hours
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
Active
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
Clear
Prerequisites
Gitbasic HTML and Django templates
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
85