How I Use My Own Product to Maintain Its Help Docs

The Past

I am the product manager for the SaaS product, Apidog. It has been online for over two years and offers a wealth of features related to API development, testing, and documentation. This also means it requires a comprehensive set of help documents.

Previously, we used the tool Docusaurus to maintain our Help Docs. It is a document tool based on Markdown with rich customization features.

But using Apidog entirely to maintain help documentation was a new experiment.

I thought I should try it. If I could create a beautiful example, perhaps companies using Apidog for API documentation might also use it for their help documentation.

I began this experiment around Septemper 2024.

Apidog directly supports Markdown, so the first step was simple: migrate the documentation originally maintained in Docusaurus over.

One great feature is that Apidog supports a much more powerful syntax than native Markdown. For instance, it includes effects like Card, Image Background, Step, Highlight, and more.

However, during this process, I also discovered some shortcomings in Apidog’s documentation capabilities.

For example, it doesn’t support document slugs and uses numbers as URL suffixes instead, which is obviously not good for SEO.

Additionally, it only supports searching within document titles, not the content, which is clearly inadequate for help documentation.

Fortunately, I am the product manager for this product. For me, these are two high-priority demands in the backlog.

This was in October 2024.

New Features

On October 25th, we released version 2.6.26. This version supported custom Slugs and automatic Slug generation based on document names.

Now, I have a set of beautiful, powerful help documents maintained using our own product. I equipped it with custom domains and navigation, and it looks perfect.

The best part is that there is no longer a need for a pull and MR each time, and each product manager can directly maintain the help documentation for their newly launched features. Efficiency and effectiveness have increased significantly compared to before.

Our technical support team can also directly maintain frequently asked questions from emails or Discord into the Support section, just using Apidog.

All images can be directly uploaded to Apidog space without needing special tools to upload them to a CDN.

In early December, our new version of Apidog Help Docs went live. You can read it at

Now I can proudly say that Apidog is an excellent tool for maintaining help documentation and API documentation. Most of the above features are free.

Using Apidog to maintain our help documentation was the best decision I made in the second half of 2024.