Docs.ansible.com revamping redirects for 2.x versions of the docs

The Ansible community team is planning to consolidate redirects for Ansible 2.x documentation. We’ve advertised this effort in the Bullhorn and the forum for a while now and plan to make the change on Monday Feb 24, 2025 .

If you have bookmarks or links to Ansible 2.x documentation , you will notice a change when you attempt to access those URLs. At present, there are redirects for plugin and module pages that open to the corresponding collection page. To facilitate these redirects, we are maintaining thousands of individual redirect rules. Over time these rules get broken and result in 404 errors. Additionally having a large number of specific redirect rules for end-of-life content restricts the ability to migrate to modern hosting platforms that offer a better user experience with cross-project search and other nice features.

The change you will notice after we consolidate the redirects is that all 2.x plugin and module pages will open to an updated version of the docs.ansible.com/collections.html page.

We invite you to review our plans and provide feedback before we flip the switch and consolidate the redirects on Monday. You can find all the details in this forum post: Consolidating redirects on docs.ansible.com.

That post provides specific examples about the change as well as the related PRs. Please feel free to review all the details and share your thoughts and opinions by replying to the forum post or commenting on one of the PRs. Thank you!

1 Like