Adding Documentation Using API Publisher

You can add different types of documents to an API. Proper documentation helps API publishers to market their APIs better and sustain competition. Follow the steps below to add documentation to an API using the API Publisher Web interface.

1. Log in to WSO2 API Publisher with a user who has been assigned the creator role. For information on users and roles, see Managing Users and Roles.
2. The currently available APIs appear on the All APIs window. Select the API to which you want to add documentation to.
   
3. Select the Docs tab of the API and click the Add New Document link.
   Documentation can be provided inline, via a URL or as a file.
   
   • In-line: Documentation hosted in the API Manager itself. For inline documentation, you can edit the contents directly from the API publisher interface. You get several documents types:
     
     • Swagger documents
     • How To
     • Samples and SDK
     • Public forum / Support forum (external link only)
     • API message formats
     • Other
   • URL: If you already have comprehensive documentation managed by an external configuration management system, you can simply link to those file references (URLs) through the API Manager rather than importing them to the server.
4. Click the Add Document button to complete.
5. The added document shows on the same window. Click the Edit Content link associated with it.
6. The embedded editor opens allowing you to edit the document content.
   

All documents have unique URLs to help improve SEO support. After editing the API, publish it for it to be available to external parties through the API Store.

 Next, see Adding Documentation Using Swagger.