If you create a feature to host a Docs page in the future, please improve on Postman's.
Theirs lacks key features and introduces bad ones:
1. Locks you into their Collections datamodel. Results in the API being maintained outside OpenAPI generated files because your annotations can't be easily merged with new endpoints.
2. Unable to password protect the API docs, even with a basic password.
3. Unless this changed recently, there is no way to re-order the endpoints or the responses without manually removing and re-adding them! Absurd.
Theirs lacks key features and introduces bad ones:
1. Locks you into their Collections datamodel. Results in the API being maintained outside OpenAPI generated files because your annotations can't be easily merged with new endpoints. 2. Unable to password protect the API docs, even with a basic password. 3. Unless this changed recently, there is no way to re-order the endpoints or the responses without manually removing and re-adding them! Absurd.