Company
Date Published
Author
Adam Altman
Word count
545
Language
-
Hacker News points
None

Summary

API discovery is a crucial aspect of managing multiple APIs within an organization, particularly when each API is maintained by separate teams following a microservices approach. This discussion explores different methods for organizing API documentation, such as using a unified sidebar that presents all APIs in a single navigation pane, distinct sidebars for each API that provide contextual navigation, and a drilldown sidebar that offers a hybrid approach by allowing users to explore deeper levels of API documentation while maintaining a connection to the parent sidebar. Additionally, showcasing an API catalog on a landing page through tiles representing each API product and implementing a search feature within the Redocly Developer portal are highlighted as effective strategies for enhancing API discoverability. The text invites feedback on alternative approaches to API organization to better support consumer access and navigation.