Welcome, Guest. Please login or register. Did you miss your activation email?

Author Topic: Redirect to Latest X.Y Version  (Read 5625 times)

0 Members and 3 Guests are viewing this topic.

kitteh-warrior

  • Guest
Redirect to Latest X.Y Version
« on: July 09, 2015, 12:00:13 pm »
Hello, I have noticed that some people are seeming to click on a link that is for an outdated/earlier version of SFML.
I am wondering if it would be possible to have a redirect to the latest version given the major release version, and what others think of this.

For example:
http://www.sfml-dev.org/tutorials/2.x would redirect you to the latest version of SFML 2.
http://www.sfml-dev.org/tutorials/3.x would redirect you to the latest version of SFML 3.

Separating the major release versions, because there is mostly only major API breaking changes in major releases.

There may already be a feature that does this, and I could be completely blind to the fact. :)

eXpl0it3r

  • SFML Team
  • Hero Member
  • *****
  • Posts: 11032
    • View Profile
    • development blog
    • Email
Re: Redirect to Latest X.Y Version
« Reply #1 on: July 09, 2015, 12:16:07 pm »
It won't solve the problem. Many just use Google and take whatever result they get from there.
Official FAQ: https://www.sfml-dev.org/faq.php
Official Discord Server: https://discord.gg/nr4X7Fh
——————————————————————
Dev Blog: https://duerrenberger.dev/blog/

kitteh-warrior

  • Guest
Re: Redirect to Latest X.Y Version
« Reply #2 on: July 09, 2015, 01:40:09 pm »
True. I never thought of that. Highlighting the text at the top of the page that specifies which version of SFML the tutorials are for wouldn't help, either (because people often look past things that are even highlighted for some reason).

dabbertorres

  • Hero Member
  • *****
  • Posts: 505
    • View Profile
    • website/blog
Re: Redirect to Latest X.Y Version
« Reply #3 on: July 09, 2015, 11:32:46 pm »
What about a link at the top of a page to the latest documentation?

That way, people that want to can get to the older documentation easily, and people who don't know what they're doing can get the latest.
I've seen MSDN do something like that.

eXpl0it3r

  • SFML Team
  • Hero Member
  • *****
  • Posts: 11032
    • View Profile
    • development blog
    • Email
Re: Redirect to Latest X.Y Version
« Reply #4 on: July 09, 2015, 11:45:48 pm »
What about a link at the top of a page to the latest documentation?
On which page?
Official FAQ: https://www.sfml-dev.org/faq.php
Official Discord Server: https://discord.gg/nr4X7Fh
——————————————————————
Dev Blog: https://duerrenberger.dev/blog/

dabbertorres

  • Hero Member
  • *****
  • Posts: 505
    • View Profile
    • website/blog
Re: Redirect to Latest X.Y Version
« Reply #5 on: July 10, 2015, 04:02:06 am »
On all of them might be best I think. That way, if someone googles, and finds the old docs, no matter which one they go to, they get a link to the latest. Ideally, a link to the latest version of the same function/class/etc. If that class/function no longer exists, maybe a link saying "this is deprecated", and just points to the top page of the latest docs.

Sounds like a lot of not very fun work, but, hey, that's what the website is on github for, for pull requests, right? Haha.

G.

  • Hero Member
  • *****
  • Posts: 1593
    • View Profile
Re: Redirect to Latest X.Y Version
« Reply #6 on: July 10, 2015, 04:43:31 am »
When you click on learn it's already the latest version.

dabbertorres

  • Hero Member
  • *****
  • Posts: 505
    • View Profile
    • website/blog
Re: Redirect to Latest X.Y Version
« Reply #7 on: July 10, 2015, 05:18:25 am »
It won't solve the problem. Many just use Google and take whatever result they get from there.

This is what I'm talking about.

Nexus

  • SFML Team
  • Hero Member
  • *****
  • Posts: 6287
  • Thor Developer
    • View Profile
    • Bromeon
Re: Redirect to Latest X.Y Version
« Reply #8 on: July 10, 2015, 09:52:13 am »
A banner with a link to the latest version is a good idea. The Boost documentation does it like this, too.
« Last Edit: July 10, 2015, 09:54:12 am by Nexus »
Zloxx II: action platformer
Thor Library: particle systems, animations, dot products, ...
SFML Game Development:

Laurent

  • Administrator
  • Hero Member
  • *****
  • Posts: 32498
    • View Profile
    • SFML's website
    • Email
Re: Redirect to Latest X.Y Version
« Reply #9 on: July 10, 2015, 10:04:27 am »
That's what was done previously (SFML 1), I don't remember why we removed it.

Quote
Sounds like a lot of not very fun work
Not that much, there's a common header for all the tutorials of a given version. So we could simply add something there.
Laurent Gomila - SFML developer