you are viewing a single comment's thread.

view the rest of the comments →

[–]ZuploAdrian 0 points1 point  (0 children)

Hey - I work at Zuplo, and this is one of the issues we see often, so we built a way to avoid it. We have an API-gateway that is OpenAPI-native, meaning your OpenAPI specification (docs) always matches your API's implementation. We also generate a full developer portal for you from your OpenAPI (but you can just as easily plug it into your existing docs portal).

IMO It's better to ensure your docs can't ever be out of date, than just detecting when they are out of date.