Details
-
Type:
Improvement
-
Status:
Open
-
Priority:
Minor
-
Resolution: Unresolved
-
Component/s: Documentation
-
Labels:None
Description
Hey guys-
This is just a general suggestion about the website - I'm note sure if there's a better place to put this. In Symfony - following PHPUnit's lead - we removed the documentation's version from the URL and replaced it with "current". For Doctrine (taking the ORM as an example), this would mean that:
http://www.doctrine-project.org/docs/orm/2.0/en/
becomes
http://www.doctrine-project.org/docs/orm/current/en/
We made this change in Symfony-land in response to users complaining - from symfony1 - that googling always returned out-of-date documentation. This makes sense if you have the version in the URL, as all of your backlinks will link to a specific version (e.g. "2.0"), keeping the rank on that version high even as it becomes out-of-date.
Just a suggestion! Should be as easy as a symlink, but do with it what you will.
Cheers!
I should also add that just making the "/current" URL work is not enough - all possible links should be changed to "/current" so that - hopefully - google will index that URL. In the most hardcore world, a 301 redirect could be setup from "/2.0" to "/current" until 2.1 goes stable (at which point 2.0 would once again resolve to the 2.0 docs).