Overview

In the admin portal of an API management platform, users can add documentation for individual API Products. This feature is crucial as it significantly enhances the clarity and usability of API Products for developers. This guide will explain how to effectively create a documentation page and designate it as the overview page in the developer portal.

Open

Developer Portal - API Products - Overview

Adding Documentation

To begin, you need to log into the admin portal and navigate to the "API Products" section. Here, you can select an existing API product or create a new one. Once you have chosen the specific API product, you will find an option to add documentation. This documentation is vital as it serves as the primary source of information for developers who want to use this API Product.

Choosing the Documentation Format

The portal offers the choice between Markdown and HTML (Rich Text) for creating the documentation. Markdown is particularly suited for those who prefer a simpler syntax and want to create content quickly without worrying about complex formatting. HTML, on the other hand, allows for richer formatting, which can be advantageous for more complex documentation needs.

Setting the Overview Page

After creating the documentation, you can decide if it should serve as the overview page for the API product in the developer portal. This setting is crucial as it is the first page a developer sees when seeking information about an API product. A well-designed overview page can significantly enhance usability and help developers quickly find the information they need.

Table of Contents