Add canonical urls to /current to all old version of the guides

[acorncom]

As we worked through (at some length) in #1185 having multiple versions of the guides in search engine indices ends up diluting our ability to actually find anything using Google search. It's not an ideal situation. We'd been pending adding canonical urls to our old versions of the guides while we worked on adding better search to those versions of the guides, but that work has hit some snags (see #1750 for an example). Rather than have that block us indefinitely, I'm starting in on adding canonical urls. Help here would be much appreciated.

We need to do two things to get this work done.

First, we need to add the canonical url to the appropriate branch of the guides (see 60573df for an example) and send in a PR with the change to the appropriate branch:

• 1.10
• 1.11 (V1.11.0 updates #1817)
• 1.12 (copy the PR to 1.11)
• 1.13 (copy the PR to 1.11)
• 2.0 (copy the PR to 1.11)
• 2.1 (copy the PR to 1.11)
• 2.2
• 2.3
• 2.4
• 2.5
• 2.6
• 2.7
• 2.8
• 2.9
• 2.10
• master

Second (this is the harder part), we need to send in the built version of the guides to the https://github.com/emberjs/guides.emberjs.com repo. To do this, you'll need to do the following steps:

1. bundle exec middleman build in your updated guides repo
2. replace the snapshots/<version> folder in the guides.emberjs.com repo with the new build folder in your guides repo
3. run node task/update-version.js <version> in the root of the guides.emberjs.com repo to update some necessary places in your new built files
4. send in a PR

These are the versions that still need to be updated:

• 1.10 (Updating search system for v1.10 guides guides.emberjs.com#34)
• 1.11 (Shifting to canonical urls for v1.11.0 guides guides.emberjs.com#35)
• 1.12 (PR should look similar to v1.11)
• 1.13
• 2.0
• 2.1
• 2.2
• 2.3 (Updating old versions of the docs guides.emberjs.com#33)
• 2.4 (Updating old versions of the docs guides.emberjs.com#33)
• 2.5 (Updating old versions of the docs guides.emberjs.com#33)
• 2.6
• 2.7
• 2.8
• 2.9
• 2.10

[acorncom]

I've just updated versions 2.3, 2.4 and 2.5 with the canonical url to test how that affects things with the search engines. Will check on that next week and slowly roll that out on the other versions

[aureliosaraiva]

@acorncom Do you still to need help?

[acorncom]

@aureliosaraiva I sure do! At this point on the above, I'm inclined to leave this issue alone (but open) until we've changed over to a different build system. But if you've got time/interest, I started in on exploring shifting to a single-repo approach to our guides here: #1821

Right now, all our guides are built statically at the time of a new release and the built files are copied over to https://github.com/emberjs/guides.emberjs.com It has become a maintenance headache as we adjust designs, update search, etc. If you're interested in helping, would be happy to discuss things further either on the PR above or on the Ember Community Slack. Let me know what you think.