djangoproject.com icon indicating copy to clipboard operation
djangoproject.com copied to clipboard

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

Open ulgens opened this issue 7 months ago • 5 comments

Resolves https://github.com/django/djangoproject.com/issues/2094

CleanShot 2025-06-17 at 16 23 53@2x

I copied the link from "Installation guide" link on the sidebar, please let me know if we prefer a different target for the link.

CleanShot 2025-06-17 at 16 28 53@2x

I'm open to suggestions about wording and styling.

ulgens avatar Jun 17 '25 13:06 ulgens

@ulgens

Thanks for pushing this PR! Since the main logic is in place and you're open to someone continuing the work, I'd love to take it forward and handle the remaining styling updates.

AyushPatiTripathi avatar Jun 17 '25 15:06 AyushPatiTripathi

@SomeAB @sabderemane Do you have any recommendations for styling? I think the default styling for this link looks a bit weird, but I'm not sure what would be the correct way.

ulgens avatar Jun 18 '25 09:06 ulgens

  • Styling: I would not even make it a separate color. I would probably leave it the same color with underline. That is a good enough styling for inline links.
  • Wording: I would word the sentence something like "Please check the latest version.", with the "latest version" anchor linked. "here" is usually not a good word to link.

SaptakS avatar Jun 25 '25 07:06 SaptakS

@ulgens Please feel free to ping me on discord or here. I'm more active on discord. Sorry for the delay in reply

A. Regarding the wording: I would personally recommend: "Please click here for the stable version"

Rationale: saying 'stable' instead of 'latest' is more inline with the previous sentence, which points at the depreciation of the doc version currently being viewed. Implicitly, we are recommending the latest LTS (link should point to LTS version given its long term support)

Two ways of highlighting: 'here' or here

B. Regarding Color: I agree with SaptakS here, that making it as the same color (dark) is preferable.

Rationale: Given the Django website uses an unusual combo of peach-pink with leaf-green, introducing new colors would just stick out badly. The highlight is suppose to be just a small nudge .. just enough to tell that it is clickable


Preview of two versions:

This document is for an insecure version of Django that is no longer supported. Please click 'here' for the stable version.

This document is for an insecure version of Django that is no longer supported. Please click here for the stable version.

SomeAB avatar Jun 30 '25 20:06 SomeAB

I agree with Saptak for the styling and the wording. The wording "Please check the latest version.", with the "latest version" anchor linked is better. The link "here" isn't meaningful on it's own. Almost everywhere on the website, links are underline with a slightly change on hover, for consistency it's better to have something similar.

sabderemane avatar Jul 19 '25 13:07 sabderemane