Redirect GH Pages docs to ReadTheDocs

[agilgur5]

Summary

As part of argoproj/argo-workflows#11390 (specifically argoproj/argo-workflows#11390 (comment)), I noticed that Rollouts still has a GH Pages docs site up and that it doesn't redirect to RTD.

We should add redirects from GH Pages to RTD, similar to the ones that CD and Workflows have.

Use Cases

1. Replace all GH Pages docs pages with meta redirects.

   • This requires a PR to the gh-pages branch. See chore: Update GitHub pages to redirect to readthedocs argo-workflows#12362 for an example of this. Specifically this Python script with an HTML template originally from chore: Update GitHub pages to redirect to readthedocs argo-workflows#12362 (comment)
     • This leaves in some of the CSS and HTML so that it looks similar & official, and then redirects you to RTD. It also has a small link for some browsers which don't successfully perform the meta redirect.
     • It will need to be slightly modified for Rollouts's purposes, but most of it can be used as is
     • This should take care of removing the unusable version drop-down on Rollouts's GH Pages site as well

2. Ensure any links to GH Pages are changed to RTD if they haven't already been changed

3. Remove the "Deploy" step from the GH Pages publish workflow

   • Can also remove the write permissions with that, which is a nice touch for security purposes
   • Could remove the entire gh-pages.yaml workflow as it appears to only run on master builds.
     • I would suggest still running it during CI on PRs so that PRs must pass the docs build. It seems to not be running on PRs right now.
     • Also should pin the versions of the docs build tools for consistent builds and security purposes. Here's Workflows's minimal pin

---

Message from the maintainers:

Impacted by this bug? Give it a 👍. We prioritize the issues with the most 👍.