Re:Ask HN: Why is there no standard for API documentation?
by quambene on Thursday June 10, 2021 @05:47PM
(#27466250)
But it seems this standard is not adopted widely?! To be more accurate, I would have to reformulate my question: Why is there no widely adopted standard for api documentation?
[ Parent
| on HN ]
Re:Ask HN: Why is there no standard for API documentation?
by kkirsche on Friday June 11, 2021 @09:40PM
(#27480599)
So I work with this field and evangelize OpenAPI at work. The simple fact is, very few developers actually know about it, and the pool of online tutorials that don’t mention it so vast, I think it becomes a problem of scale and knowledge. Some companies use it, VMWare for example uses it for the fusion API documentation. But it’s 100% dependent on having at least a few devs at whatever company who have enough power to push for this as important