In my experience, API teams are much more successful using a design-first approach, starting documentation earlier and iterating through the development process.

Improved developer experience (38%) API Strategies are Still a Work in Progress: Less than one-third of organizations (31%) have a fully executed API program or strategy, ...

With public workspaces, developers from one or more organizations can experience all the API lifecycle elements—schema, mocks, tests, monitors, documentation, and collection—in a single workspace.