News for hackers. Stuff that matters.

A comment on Ask HN: Is OpenAPI Documentation Superior?. Parent comment

Re:Ask HN: Is OpenAPI Documentation Superior? by hirokib on Thursday March 25, 2021 @05:30PM (#26585649)
So there is an intuitive aspect that brings comfort? I think that's super important. Especially in healthcare where most APIs/dev experience is terrible, making someone feel at home seems really important.
[ Parent | on HN ]
Re:Ask HN: Is OpenAPI Documentation Superior? by bigiain on Thursday March 25, 2021 @08:49PM (#26587625)
Not so much “intuitive“, much closer to “familiar”. I don’t expect an API doc tool (or any useful/powerful dev tool) to be zero learning curve, but I don’t want my team climbing 2 or 3 different learning curves unnecessarily.

But yeah, totally right on the “feeling at home” idea.

[ Parent | on HN ]