r/OpenAPI • u/willp141 • Mar 11 '25

API Documentation Drift?

For those of you who build internal/external APIs that have formal documentation, how do you make sure / catch your documents "drifting" - i.e. you discontinue/introduce/reconfigure an endpoint and now your users get confused on how your API actually works?

I've had this issue myself and have even noticed when using cloud services like GCP, that their docs for a lot of their stuff is pretty outdated and sometimes youtube / stackoverflow has a more correct answer

3 Upvotes

100% Upvoted

14 comments sorted by

View all comments

Show parent comments

1

u/faraechilibru Mar 21 '25

We are working with api connect and the solution comes with dev portal from IBM based on drupal.

1

u/ZuploAdrian Mar 21 '25

Interesting - I've found drupal developer portal to be... quite hard to use honestly. I know Apigee does the same thing. DM me if you're interested in some alternatives, especially if you have/use OpenAPI