OpenAPI and Transparent Process
LaunchDarkly has dedicated significant time to improving their console's speed and usability. However, they recognize that some users may prefer using an API for creating and managing feature flags. Since LaunchDarkly uses its API to drive the dashboard, it is easy for them to keep everything in sync when making changes to the API. They started with ReadMe for documenting their API but later switched to Swagger/OpenAPI due to its popularity, ability to generate code snippets and examples in various languages automatically, and ease of adding context and documentation. LaunchDarkly's REST specification is available on OpenAPI, and they continue to work on enhancing the documentation with examples, descriptions, and context. Users can provide feedback through their contact channels or directly in the repository.
Company
LaunchDarkly
Date published
Sept. 19, 2017
Author(s)
Heidi Waterhouse
Word count
218
Language
English
Hacker News points
None found.