๐ฉ Hello, this is Nick from Zylosystems โ hope youโre doing well this week!
In our previous newsletter, we explored what makes API docs truly developer-firstโcomparing the polished, hosted approach of Fern with Zylo-docsโ code-native, real-time foundation. This time, weโre turning our attention to the spec that powers most modern API docs: OpenAPI.
OpenAPI 3.2 is nearly here. With over 94% of its issues resolved, this release marks one of the most practical and forward-thinking evolutions of the spec. From flexible tag structures to official support for QUERY and multipart responses, itโs clear that the spec is catching up with how real APIs are built and shipped.
At Zylosystems, weโre not just watching the spec evolve โ weโre evolving with it. Zylo-docs is already adapting to OpenAPI 3.2โs improvements, enabling richer, more expressive docs for modern teams.
๐ Topics covered in this twelfth newsletter:
- What OpenAPI 3.2 changes โ and why it matters for real APIs
- How structured tags now support hierarchy, metadata, and grouping
- Why the spec now welcomes extended methods like QUERY
- How full support for multipart/* unlocks rich, streaming responses
- What Zylo-docs is doing to support these updates โ today, not โeventuallyโ
๐ Dive deeper on the blog:
๐ Why Great API Docs Matter โ And How Zylo-docs Takes It Further | 
