customer story
Gravitee
How Gravitee scales documentation across teams with GitBook

Gareth Brinn
Documentation Manager

For Graviteeâs technical writing team, documentation isnât just about helping users â itâs an important tool for accelerating sales cycles, reducing support burden, and creating incredible first impressions for prospects discovering the platform through search.
As an API management platform with multiple product lines and teams, Gravitee needed a documentation platform that could keep pace with rapid development â and promote company-wide collaboration.
We spoke with Gareth Brinn, Documentation Manager at Gravitee, about how GitBook transformed their approach to documentation and enabled collaboration at scale.
The challenge: plug-and-play over build-it-yourself
Competing with larger corporations, Gravitee needed to be strategic about where they invested engineering resources.
The team needed a solution that would work out of the box â with the flexibility to create a great documentation experience without the need for custom development.
Unlocking company-wide docs contributions
With several different feature teams â plus support and field teams â Gravitee has a lot of cross-departmental collaboration. GitBookâs intuitive interface made it easy for both technical and non-technical contributors to get involved in docs workflows.
âIt helps every department â itâs just easy cross-collaboration. We donât have to work with multiple tools. One tool does it all, and we donât have to hold somebodyâs hand through the documentation creation process. Itâs made life very easy.â
Simplifying documentation workflows
One of the biggest benefits for Gravitee has been keeping the entire documentation process in one place â from drafting, to review, to publication.
âGitBook keeps it all centralized in one application. Iâve worked at corporations before where you had to use two or three different tools to get to publication, which is a lot of red tape. Keeping it in one place is great for us.â
This centralization extends to their review process as well. The team can easily share work-in-progress documentation with subject matter experts using a preview link, and get instant feedback.
Flexible workflows with Git Sync
While most contributors use GitBookâs visual editor, the team also appreciates the flexibility of Git Sync for those who prefer working in GitHub.
âCertain teams prefer to work in GitHub using Markdown, because they do everything in GitHub and want to keep it all in one application. So itâs great that we can use Git Sync to collaborate.â
The technical writing team handles the backend setup â creating spaces, configuring Git Sync, setting up change requests â so that contributors can focus purely on content without worrying about the technical details.
Documentation as a strategic sales tool
Beyond serving existing customers, Gravitee also uses its documentation for lead generation and sales enablement. The team works closely with their SEO specialist and use GitBookâs built-in SEO optimizations to ensure the documentation ranks well for key searches.
âWhen people Google âAPI managementâ and land on our docs site, they see itâs easy to use, click âContact Gravitee,â and the whole journey starts. We use it for prospects, generating leads, and to reach people before our sales team does.â
The strategic approach is paying off. Gravitee has seen their documentation outperform competitors in search rankings and customer evaluations.
âWeâd heard that we outranked a competitor. It shows that it is working â the processes weâre putting in place and GitBookâs hosting of our site.â
Graviteeâs documentation now serves as a point of entry that impresses prospective customers and accelerates the sales cycle for both organic and sales-qualified leads.
Responsive product development
One aspect that particularly impressed the Gravitee team is GitBookâs continuous innovation and responsiveness to customer feedback.
âWith plug-and-play models, youâre often limited. But with GitBook, if it doesnât exist the team builds it quickly. If we say we need something, even if itâs complex, a month later the GitBook team are like âHereâs version one, version two will be ready in two weeksâ.â
Beyond the product itself, the team values GitBookâs support approach.
âWe love how easy it is to work with the GitBook team. We put a question into the chat, somebody responds almost immediately. If thereâs a feature that we want, they help us by either building the feature or showing us existing features and how they can help. GitBook has always been a great partner to us.â
Looking ahead: analytics and continuous improvement
While the team has focused on foundational documentation improvements, theyâre excited about leveraging GitBookâs analytics capabilities more extensively in the future.
âProduct managers are really excited by GitBook Insights â to understand how people are coming to the product, what theyâre searching for, how theyâre getting there. Once weâre happy with the foundational work, weâll use Insights to pinpoint where we need to improve.â
For Gravitee, GitBook has become more than just a documentation platform â itâs the foundation that enables strategic documentation at scale, from prospect to customer, across a distributed team.
Ready to create documentation that scales with your team and supports your sales process? Get started for free or reach out to our team to see how GitBookâs powerful organization tools can handle even the most complex documentation needs.
â How does GitBook handle SEO?
â Using Git Sync for collaborative documentation
â AI-powered documentation: the future of customer support
