The next evolution of Red Hat documentation is here

As we at Red Hat continue to evolve our products, we are also transforming how you consume the information needed to run them. We are excited to announce a wave of significant enhancements coming to the Red Hat documentation experience at docs.redhat.com.

These changes are rolling out over time, with the documentation for Red Hat Ansible Automation Platform 2.6 serving as the pioneer for this new look and feel. Here’s a breakdown of what you can expect and how these changes will improve your workflow.

Finding your way: Unified table of contents

One of the most noticeable updates is the introduction of a unified table of contents (TOC). Previously, navigating between different guides or sections could feel disconnected. Now, the TOC provides a holistic view of the product documentation for a version, allowing you to see where you are within the larger product context without losing your place. It also removes the friction of having to bounce back to the Hub page to switch guides. 

You’ll find the TOC stays accessible as you scroll, which makes it easy to jump between pages. We’ve also added a TOC filter so you can instantly narrow down the list and find the specific topic you need, and we’ve cleaned up the TOC design and provided a simpler experience by eliminating a UI quirk where a duplicated heading link can appear nested under itself. Jump to Section links show you at a glance what content is on a page, as well as providing page-level navigation. 

For those who still need offline access, PDF versions remain available for download, and are now accessible directly from each topic in the table of contents.

Content reorganized: From Guides to Jobs To Be Done

We are shifting away from traditional, monolithic manuals and moving toward a Jobs To Be Done (JTBD) framework.

What does this mean for you? Instead of searching through a large Installation Guide to find one specific configuration step, you’ll now find content organized around the actual tasks you are trying to accomplish. Whether you are setting up a private automation hub or migrating to containerized installers, the documentation is structured to get you to the solution faster. This outcome-oriented approach reduces noise and helps you focus on the task at hand.

HTML page format

We’ve refined our page formats to improve readability in response to reader requests. As part of this improvement, we are moving away from providing single-page HTML format pages. Many of you provided feedback that our documentation is a “wall of text” and have asked for a more easily scannable content presentation with a simple layout. Long HTML pages also had negative impacts on browser performance and caused user frustration. The use case-oriented pages from our retired docs.openshift.com site were popular. “The OpenShift documentation had the best structure among all products. This should be used as the baseline," one typical user told us.  

Based on this feedback, we concluded that our multipage HTML format provides too little information for users, but our single-page HTML format can overwhelm users with too much information at once. So we are moving to providing only one HTML page type, focused on one JTBD. 

Version switching

We know that many of our users manage environments across multiple product versions. To help, we’ve added version switching directly on content pages. You no longer have to go back to the landing page to see how a specific feature worked in a previous release; you can simply toggle the version dropdown at the top of the page to see the relevant content instantly.

Better search, better results

We’ve overhauled our search backend to provide better, more accurate results. 

Looking ahead

The Ansible Automation Platform 2.6 documentation is just the beginning. Over the coming months, you will see these improvements—unified TOCs, JTBD-organized content, and version switching—rolling out across the entire Red Hat product documentation portfolio.

Our goal is simple: to help you spend less time looking for answers by quickly serving you the trusted Red Hat content you need to be successful. Explore the new Ansible Automation Platform 2.6 documentation today and let us know what you think!