Closesmatplotlib/matplotlib#15213,
i.e. a search for something like "matplotlib rcparams" would lead tohttps://matplotlib.org/users/customizing.html, which is an abandonned version of the currenthttps://matplotlib.org/tutorials/introductory/customizing.html

Also tackles#39 (comment) by@Carreau (who has already added canonical links to a huge bunch of files in an automated way).

This PR only touches theusers/ folder. That folder contains content from the current docs, as well as totally old stuff from the mpl 1.5 docs. It is hence particularly hard to handle it in an automated way.

Here the following is done:

• Since this folder is not versionned, it's best to redirect all old html files to the canonical version of the current docs. Also, a canonical link is added. E.g. forusers/annotations.html

  <meta http-equiv="refresh" content="0; url=../tutorials/text/annotations.html" /><link rel="canonical" href="https://matplotlib.org/tutorials/text/annotations.html" />

  But for exampleusers/style_changes.html redirect tousers/dflt_style_changes.html, there are other special cases as well.

• images and .py files are deleted if they are not part of the current docs any more. This might break very rare cases where someone directly linked to an image in the users folder, but I think one needs to make a cut at some point. Also the respective current docs often overwrite older images from the whats_new section anyways. The old files are still in the versionned folders, e.g.2.0.2/users/..., in case they are desperately needed.

I expect theusers/ folder to take a large portion of page hits to outdated files, but it would be nice to verify via some analytics, c.f.#23 (comment),@tacaswell.