4 ms·
Ask HN: What Makes API Documentation Great?
What specifically makes documentation great? Example: something about the design, format, where it's located, structure, video tutorials/no tutorials. Examples would be really helpful. Also, if you are a developer, do you tend to spend time reading documention before going forth and testing it out or not? Thanks!
- mtmail 11y agoThis list contains lots of good examples https://github.com/PharkMillups/beautiful-docs https://github.com/PharkMillups/beautiful-docs For our service (http://geocoder.opencagedata.com/ http://geocoder.opencagedata.com/) we can't use many API-docs-autogeneration tools because their typical usecase is dozens to 100s of methods (think: Stripe). We only have one endpoint and a couple of aliases.
- brandonlipman 11y agoThis is awesome. Thank you!
- strongai 11y agoLike you said, examples would be [are] really useful!