Check out A nine-point strategy for developing a successful API documentation portal by ellis. Here is an excerpt:
Below is a strategy for developing a successful API documentation portal. By following these steps, you can create a plan for building a documentation portal that meets the needs of your API…