CHALLENGE
Novu’s documentation had grown without a clear structure. Tutorials and conceptual guides were interspersed with task instructions and reference materials, making it more difficult for developers to locate what they needed. There was also no defined process to ensure that updates shipped alongside new features.
SOLUTION
Working alongside Novu’s team, Hackmamba introduced a structured process to rebuild and maintain their documentation:
- Documentation audit: Identified broken tutorials, high-traffic endpoints that triggered support tickets, and pages where concepts and tasks overlapped.
- Content redesign: Organized tasks, references, and concepts into clear sections to reduce confusion.
- Tutorial rebuilds: Rewrote onboarding and end-to-end tutorials to make them accurate, testable, and easy to follow.
- Embedded in sprints: Joined standups and sprint planning to create documentation in parallel with feature development.
- Repeatable process: Added a release checklist that made documentation a requirement for every feature release.
- Team enablement: Trained Novu’s team to identify well-structured docs and maintain the new system over time.
They accelerated our feature delivery while giving expert feedback on what works and what doesn’t – Dima Grossman, Co-founder and CTO, Novu
RESULTS
- Achieved a 100% increase in shipping velocity by aligning documentation with each feature release.
- Rewrote broken tutorials and improved onboarding flows.
- Restructured content into clear concepts, tasks, and references.
- Implemented a scalable documentation process integrated with engineering workflows.
- Reduced maintenance overhead by keeping docs and product updates in sync.
Working with Hackmamba is like having a 10x technical writer on your team- Dima Grossman, Co-founder and CTO, Novu
Requirements
Novu were looking for a clear documentation structure that allowed developers to self-serve, a workflow to ship documentation alongside new features, and a team that could collaborate directly with engineers to embed documentation into the release cycle. Hackmamba partnered with Novu to achieve these goals and build a documentation process that grows with the product.
Novu worked with Hackmamba to rebuild its documentation process. The new workflow made it easier for the team to update content and ship documentation with every feature release. As a result, Novu doubled its shipping speed and improved the overall developer experience.
GET DETAILS ON WHAT WE'VE DONE
