DX is as important as UX

Alix Gallardo
4 min readMar 16, 2023

It’s common for companies and individuals to focus solely on user experience, often overlooking the importance of Developer Experience (DX). This means that they may neglect the needs and experiences of the people who create the software: the developers.

Why is important to care about Developer Experience?

If you want to build a scalable product, a powerful platform, or any kind of software that is intended to be used by other developers, it is crucial to care about Developer Experience (DX). DX refers to the overall experience that developers have while working with your product or platform, including the ease of use, the quality of the documentation and support, the availability of resources and tools, and the level of satisfaction that developers feel when using your product.

By investing in DX, you can create a better, more user-friendly experience for developers, which can lead to a number of benefits. For example, it can help attract more developers to your platform, increase developer productivity, and ultimately, lead to a better end-user experience by offering a seamless experience for them to start creating, building and breaking. Good DX can also foster a sense of community and collaboration among developers, as well as promote innovation and creativity, all of which can be critical to the success of any software project.

In short, caring about Developer Experience is not just a matter of making developers happy, but it can have a significant impact on the success of your product or platform, and on the satisfaction of your end-users. So, whether you are building a new platform or looking to improve an existing one, it’s essential to prioritize DX in your development process.

I am proud to say that I have always prioritized the DX in all of the projects I have built with my team, verza is no exception.

Documentation, is everything.

Good documentation is essential for any software product or platform. Without proper documentation, it’s challenging to ensure that users and developers will use your product in the way it’s intended to be used. From user experiences to developer experiences, documentation plays a critical role in helping users and developers understand the product and how it works.

When it comes to user experience, documentation can guide users through the product’s features and functionalities, providing a clear understanding of how the product can add value or solve their pain-points. This can include step-by-step guides, tutorials, videos, and other resources that help users achieve their goals while using the product. Additionally, documentation can provide feedback mechanisms that allow users to report bugs, request features, or provide general feedback on their experience, helping improve the overall user experience.

On the developer side, documentation can be even more critical, as it can impact the speed and quality of integrations with your product or service. Developers need access to comprehensive documentation that includes API references, code samples, SDKs, and other resources that enable them to understand how to integrate your product into their applications quickly. Clear and accurate documentation can also reduce the number of support requests that developers may have, as it can help them troubleshoot issues more effectively.

Best practices to create a Developer Experience:

Creating a great Developer Experience (DX) requires a lot of careful thought and planning. Here are some best practices to consider when building a developer platform:

Audience: First, it’s essential to understand your audience. Who is your target developer audience, and what are their needs and pain points? Understanding your audience will help you craft documentation and resources that are tailored to their specific needs.

Friendly: Once you understand your audience, it’s important to create clear and explicit documentation. Developers need to be able to easily understand how to use your product, so your documentation should be easy to read and understand. Consider using diagrams, screenshots, and other visual aids to make your documentation more accessible.

Format: Another important consideration is format. Some developers may prefer video tutorials, while others may prefer written documentation. It’s important to provide resources in a variety of formats so that developers can choose the ones that work best for them.

KPI’s: It’s also essential to measure the success of your documentation. You can track metrics like how long it takes developers to complete a task, how many support requests you receive, or how many developers are actively using your product. Use this data to continually improve your documentation and resources.

Use Cases: Finally, one of the best ways to create a great DX is to provide concrete Use Cases. Developers love to see real-world examples of how to use a product or platform, so providing Use Cases that showcase the power and flexibility of your platform can be a valuable tool for building engagement and excitement around your product.

Improve the experience to gain engagement and decrease churn: To create a great Developer Experience, it’s important to be receptive to feedback and provide additional support when needed. Offer multiple communication channels and one-on-one support through tools like calendly or telegram. By listening to feedback and being responsive to the needs of your users, you can build a thriving community of developers.


Furthermore, a strong sense of community is also an important ingredient for a successful Developer Experience. By fostering a community of developers who can share ideas, collaborate on projects, and provide feedback, you can create an environment that encourages innovation and growth. So, don’t forget to build a sense of community as you work to improve the Developer Experience for your platform. We can create a thriving community of innovators who are excited to build and create experiences. Let’s build community -driven products!