Doctrine Website
  1. Doctrine Website
  2. DWEB-87

Suggestion: Change the 2.0 to "current" in the docs URL

    Details

    • Type: Improvement Improvement
    • Status: Open
    • Priority: Minor 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!

        Activity

        Hide
        Ryan Weaver added a comment -

        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).

        Show
        Ryan Weaver added a comment - 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).
        Hide
        Ryan Weaver added a comment -

        Little bump - totally not critical, but this will pay off more the earlier it can be done.

        Thanks!

        Show
        Ryan Weaver added a comment - Little bump - totally not critical, but this will pay off more the earlier it can be done. Thanks!

          People

          • Assignee:
            Jonathan H. Wage
            Reporter:
            Ryan Weaver
          • Votes:
            0 Vote for this issue
            Watchers:
            0 Start watching this issue

            Dates

            • Created:
              Updated: