Gracefully deprecate legacy docs

[pedro-psb]

Progress

Some repositories didn't had doc pages before, so this task doesn't apply.

plugins

• [x] https://github.com/pulp/plugin_template/pull/860 (will auto update enabled plugins)
• [x] https://github.com/pulp/pulp_rpm/pull/3518 (ci_update_docs: false)
• [x] https://github.com/pulp/pulp_python/pull/664 (ci_update_docs: false)

others

• [x] https://github.com/pulp/pulp-cli/pull/949
• [x] https://github.com/pulp/pulp-oci-images/pull/631
• [x] https://github.com/pulp/pulp-operator/pull/1265

Approach

A) Banner with link + schedule deletion/freeze (choosed)

• Link to new docs (on the appropriate repo page)
• Inform what will happen to the legacy website (either be deleted after some day or remain freezed).

Pro: simple and low cost Cons: people with legacy links need to find the correspondent fresh content on the new docs

B) Per-Page Redirects (discarded)

• Remove old legacy content
• Create per-page redirects to matching content (no banner necessary in this case)

Pros: require more work Cons: people with legacy links will go directly to fresh content

[pedro-psb]

After some brief discussion with @decko, @dkliban and @bmbouter , we've decided the following as a general strategy:

• Schedule a redirection of for July 2024:
  • http://docs.pulpproject.org/pulp* to pulpproject.org (which will contain the current staging).
  • Dont redirect pulp2 docs (https://docs.pulpproject.org/en/2.21/), which should remain on air.
• For now, add banners to websites with schedule information and a link to the new website.

[pedro-psb]

As an small addition to this idea, instead of redirecting to the pulpproject.org home, we should redirect to a "transition section" with some minimum background and useful tips for using the new docs (such as "Help > Documentation Usage" page, which is currently a only placeholder)