Skip to main content
DevOps icon showing cogs

This post is from the XebiaLabs blog and has not been updated since the original publish date.

Last Updated Aug 21, 2019 — DevOps Expert

Meet the New XebiaLabs Documentation Site


XebiaLabs’ new documentation website is easier to navigate, search, and read. It's also mobile-friendly.

At XebiaLabs, we take our customers' needs seriously. We're interested in continuously improving our users' experience of the XebiaLabs DevOps platform, which is we're always releasing new features and product design changes--so many, in fact, that it's been hard for the documentation side to keep up! That's why over the last year, we've tripled the size of our Documentation team, so they'd be sure to have the bandwidth they need to undertake a complete overhaul of our approach to technical content delivery.   

Analyzing our Documentation

After growing the Documentation Team, we set our sights firmly on upgrading the XebiaLabs documentation website. Based on tickets from the XebiaLabs Support Team, input from our customers, and our own experience, we had a good understanding of the main issues with the old documentation site:

  • Much of the content was out-of-date and inadequate for real-world use scenarios
  • Version-specific content was highly demanded by customers
  • The search engine did not allow users to target the content they required
  • The navigation system was outdated and made it difficult to locate relevant content

To address these issues, we started several initiatives:

  • Ran a series of workshops with SMEs where we reviewed content, tested it for accuracy, and revised it as needed
  • Created a new website to hold our existing content, with a backend that allows us to use proper versioning 
  • Introduced a powerful new search engine that enables users to filter by product and version
  • Partnered with the XebiaLabs UX Team to create a new design for the website

Implementing the New Design

The XebiaLabs UX Team were onboard and eager to help with the design of the new site. Below, XebiaLabs UX/UI Designer Bojan Kocijan discusses his design process.

Home page

Based on our user research, we determined the main pain points of the documentation site. This helped us make important decisions around organizing the content and making scalable, easy-to-use layouts for the new site.

We discovered that most users were using the search bar instead of the navigation system to find content, so we put a lot of effort into making the site easier to navigate. We added an easier way to find and interact with the most popular topics and broke down each main content area into categories and tiles.

Navigating the Content

We completely redesigned the site navigation and display categories and related topics on tiles. This helps remove the user’s cognitive load by grouping information logically, allowing them to drill down to the content they need.


Versioned Documentation

We made it very easy to navigate to the specific version of the software our customers need in response to feedback that they often struggled to identify which parts of a topic were relevant to their platform configuration.

Reading the documentation

Based on UX patterns and best practices, we made sure that the content is easy to read. The website is also mobile-friendly and scales to all devices.

Check out the new site:

We welcome all your feedback. We will be implementing a site-wide system very soon, but in the meantime, you can leave feedback in the comments section below.


More from the Blog

View more
machine learning
Sep 30, 2021

Proactive enterprise incident management through machine learning

Organizations can leverage automation as a way to diminish human error ...
Read More
expedited journey
Sep 13, 2021

The Expedited Journey of Digital Transformation

Alan Brown, Digital Transformation Advisor at conducts a se ...
Read More
Aug 23, 2021

Is Data Analytics Missing From Your Digital Transformation?

Nearly every major enterprise is already in the process of digital tra ...
Read More
Aug 19, 2021

Creative Ways to Automate Developer Workflows

When an organization begins an Agile or DevOps journey, the process ca ...
Read More
Contact Us