API documentation writing services

Free up your developers’ time

Having Cherryleaf’s technical communicators write your API documentation is a great way to free up your developers’ time. As a result, they can focus on what they do best.

Contact Cherryleaf

It can be hard to find the time to document your APIs. With your developers used to focusing on details, this can also lead to documentation that lacks the big picture perspective. The answer is to have a Cherryleaf API documentation writer on your team.

A complete set of documentation for your audience

When writing REST API documentation, a lot of organisations use the API reference documentation that can be generated automatically from an API specification.

The downside of this approach is the automatically generated REST API reference documentation typically has its own look and feel, and navigation structure. To the user, it often looks like there are two separate sites. One contains the reference information. The other describes what the API does, why you’d use it, how to get started, how to get an authentication key, how to get a “Hello World” response, tutorials, and so on. As soon as a website’s look and feel changes, there’s a cognitive load on the reader. They need to assimilate what has changed. It’s like trying to complete a task with two manuals open at the same time.

Instead, you can create a site that has a cohesive set of documentation. This includes having REST API reference content automatically generated from the API specification. Whenever the REST API specification is updated, that content automatically updates itself. It also includes all other important information, in a comprehensive and coherent user experience. It can also enable you to include a site search, manage multiple versions, manage pro/lite products, re-use content, publish to PDF, manage localised content, manage synonyms, and avoid inserting scripts into pages that only the original creator understands.

Good API documentation builds developers’ confidence in your product, and poor documentation can be seen as a sign of a badly-maintained API.

Our API documentation services

Providing API documentation writers

We can provide you with a technical communicator skilled in writing API documentation. They can work on or off site, depending on your preference.

Fitting in with your existing development workflow

Cherryleaf’s API documentation writers can become part of your development process. You could treat documentation as code, committing it to source control, and including it in the builds.
Cherryleaf’s API documentation writers can become part of your development process. You could treat documentation as code, committing it to source control, and including it in the builds.

Creating API documentation portals for developers

Developers expect to be able to find the information they need to get things done.

This can include:

  • Getting started guides and tutorials
  • Conceptual and overview guides
  • Troubleshooting guides
  • API reference guides
  • Authentication and authorisation guides

Case Studies

“The first, laborious, step was to get all the information organized into documents in a structured and modular way. As we complete the process we will want to improve presentational aspects to give a better customer and marketing experience.

We see an ongoing role for Cherryleaf as consultants who can help to get better documents out of the vast material we have added to the system. Very importantly, Cherryleaf were able to rapidly respond to our issues with the system and help us understand. We have no expertise in this and did not want to be stuck on things that experts could solve instantly – Cherryleaf were very responsive in this. “

See: Helping HCC deal with the size and complexity of embedded systems documentation

API documentation episodes from the Cherryleaf Podcast

Contact us

Need help in developing your API documentation? Complete the contact form below. Don’t worry if you don’t know the answers to all of the questions.

We will contact you to discuss your situation and requirements.

You can always phone or email us, if you prefer.

* Required

Your name (* required)

Your email (* required)

Your telephone number

Your location *(required)

Tell us a little about your requirement *(required)

Can you tell us how much content is needed?
(Or, for existing content, how much is there?)

Tell us a little about your audience, timescales and budget.

How would you like Cherryleaf to help you?

We'd love to email you links to useful articles and news on developing content. We'll always treat your details with the upmost care, following the EU's GDPR consent rules.

No, I don't want to receive updates.Yes, I'd like to receive updates.