ipfs-inactive / docs

[ARCHIVED] 🤖 📚 IPFS documentation working group, plus IPFS docs site code
https://docs.ipfs.io/
Other
87 stars 62 forks source link

[CONTENT MIGRATION] Cool links don't break #414

Closed lidel closed 4 years ago

lidel commented 4 years ago

(apologies if this was already discussed, but don't want us to miss this)

What makes a cool URI? A cool URI is one which does not change break

https://www.w3.org/Provider/Style/URI

Motivation

Various blog posts, docs, tutorials, posts on forums and StackOverflow link to our docs. There is a big value in that. Those HTTP links should continue to work and deliver user (and crawlers) to related content in docs-v2 where possible.

Implementation

This is specific to http:// transport on regular web, so we should handle this at Nginx level. The most popular paths should return HTTP 301 to content in the new website.

Question: Do we have analytics on docs-v1? Are we able to tell which pages are visited the most? I imagine we don't need to add rules for all pages, only a small set of the most popular ones.

jessicaschilling commented 4 years ago

@lidel - Yep, this is all covered in the deprecation plan here: https://hackmd.io/-JU3CcXgSgmcXWszyku2PA

Feel free to add to that document if you see anything missing.

We do have metrics in the legacy site, and will be using those to prioritize redirects and if possible reaching out to common referrers. Thanks!

lidel commented 4 years ago

Fantastic! Added some comments / references there.