Last Updated: November 21, 2025
Spec Types
| Format | Focus |
|---|---|
OpenAPI
|
REST specs + codegen |
Postman Collections
|
Collaboration + envs |
GraphQL
|
SDL + docs |
Publishing
swagger-cli bundle
Validate + bundle spec
postman push
Sync collection
npm run docs
Build Docusaurus docs
Best Practices
Version specs, document breaking changes, and link reference docs to automation.
💡 Pro Tip:
Store specs in git, regenerate docs nightly, and keep changelog summaries with versions.