CHALLENGE
Kwala’s existing documentation was limited to basic introductory instructions and did not reflect how developers actually use the platform. Key use cases were missing, and recent product developments were not documented.
A major gap was the absence of documentation for the workflow builder, which had become a central part of the platform. Developers had no clear guidance on how to use it or how it related to the underlying YAML-based automation.
At the same time, the documentation needed to serve different audiences. External developers required practical guidance to get started, while investors and enterprise stakeholders needed a clear explanation of Kwala’s direction and capabilities. Balancing these needs without overloading a single set of documents was a core challenge.
SOLUTION
We started with a documentation audit to understand what already existed and what needed to change. This helped identify gaps around use cases and recent platform developments.
To understand the platform in depth, we reviewed a live product demo and studied existing walkthrough videos shared by the Kwala team. Ongoing async discussions and regular syncs helped clarify workflows, terminology, and developer expectations.
We redesigned the information architecture using the Diátaxis framework and implemented it on Mintlify. Documentation was structured around the workflow builder, with content written to guide developers from onboarding to implementation. In parallel, we worked on a whitepaper tailored for investors and enterprise stakeholders, including a custom diagram to explain the system at a high level.
RESULTS
- Released usable documentation on Mintlify that supported engineers ahead of the project deadline
- Structured documentation around the workflow builder to reflect how developers use Kwala in practice
- Delivered a whitepaper with a custom diagram to support investor and enterprise evaluation
Requirements
The requirements were to document the workflow builder clearly, reflect developer use cases, support external developer onboarding, and provide a separate high-level narrative for investors and enterprise stakeholders.
Learn how Hackmamba helped Kwala deliver workflow-driven developer documentation on Mintlify and a clear, investor-ready whitepaper that supported faster onboarding and product understanding.
GET DETAILS ON WHAT WE'VE DONE
